set-theme

Configures team branding for folio presentation pages via the /v1/theme API.

82|9|Updated Feb 2, 2026
One-click install
npx skills add https://github.com/awebai/aweb --skill set-theme-awebai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: set-theme
Source: https://github.com/awebai/aweb/tree/main/naapp/folio/skills/set-theme
Command: npx skills add https://github.com/awebai/aweb --skill set-theme-awebai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams sharing folio presentation pages want their public /present/<token> pages to reflect their brand identity, but manually styling each page is not possible since rendering is server-side. This Skill lets an agent read and update the team-scoped theme through the folio HTTP API. ## Core Features & Use Cases - Read current theme: Query GET /v1/theme with team authentication to inspect existing color tokens, fonts, logo, header, and footer. - Update brand tokens: Set color palettes (background, surface, text, muted, border, accent) and font choices (system, serif, mono) via PUT /v1/theme. - Logo and header/footer management: Upload a base64-encoded PNG, JPEG, GIF, or WebP logo (max 256 KiB), set header/footer text, or clear the existing logo. - Use Case: A team wants its shared document links to display company colors and a logo. The agent builds a theme JSON payload, uploads it with team authentication, and verifies the branded rendering on a present link. ## Quick Start Ask the agent to set your folio team theme with your brand colors and logo, then verify it on a present link.

Frequently Asked Questions about set-theme

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set a custom theme for folio presentation pages?

Build a JSON payload with color tokens, fonts, and optional header, footer, and logo, then send it with `aw id request PUT $FOLIO_ORIGIN/v1/theme --team-auth --raw --body-file theme.json`. The theme applies team-wide to all public present pages.

How do I read the current folio team theme?

Run `aw id request GET $FOLIO_ORIGIN/v1/theme --team-auth --raw` from a workspace with an active AWID team certificate. An empty theme returns default tokens with null logo, header, and footer fields.

What logo formats does the folio theme API support?

The API accepts base64-encoded raster images with content types image/png, image/jpeg, image/gif, or image/webp, up to 256 KiB. SVG and HTML are rejected, and bytes must match the declared content type or the request returns 400.

Can I remove a logo from my folio team theme?

Yes, set `clear_logo` to true in the PUT /v1/theme payload to remove the current logo. You can combine this with other token updates in the same request.

Why are some of my theme token values ignored?

Unsupported token keys or unsafe values are silently ignored by the server during sanitization. Only the documented color keys, font values (system, serif, mono), and header/footer strings are applied.