paseo.cafe is deprecated. Browse plugins at paseo.sh/plugins and submit new ones there. This catalog and its API stop on 2026-12-01. The Paseo Cafe companion plugin already uses the official registry and is unaffected.
paseo.cafe
All plugins

theme-studio

by Gabsplat

Design Paseo themes and UI packs with a live preview, 60 starting palettes, and a companion designer agent.

v0.8.1 Requires Paseo >=0.9.2 <0.13.0

Gallery

Install

npmjs · Paseo 0.9+

paseo plugin add npm:paseo-theme-studio@0.8.1

GitHub · Paseo 0.8 fallback

paseo plugin add Gabsplat/paseo-theme-studio --ref 877eb655e5addafac93a1c31566cd22d39051d2d

Git security status and fallback installation are pinned to commit 877eb655e5ad.

From the plugin's README

Requires Paseo 0.9.2 through 0.12.x, including their betas, with plugins enabled, and Node.js on the daemon host.

paseo plugin install paseo-theme-studio

That installs the npm package. To follow the repository instead, use paseo plugin install https://github.com/Gabsplat/paseo-theme-studio.git.

Then open Theme Studio in the sidebar and choose Theme Studio · Live once in Settings → Appearance, so the active pack's palette applies across Paseo.

To work on the plugin, or to use code components and pack export (see Limitations), install it from a checkout instead:

git clone https://github.com/Gabsplat/paseo-theme-studio.git
cd paseo-theme-studio
pnpm install --frozen-lockfile
paseo plugin install "$PWD"

README

Paseo Theme Studio

Design how Paseo looks without leaving Paseo. Theme Studio is a plugin with a live replica of the app that repaints as you edit, 60 starting palettes, and a designer agent that edits the same draft you do.

Click the image to watch the 29-second demo.

What you get

  • A live preview. A working replica of Paseo's sidebar, chat, tool rows, terminal, and composer, on desktop and mobile, painted with your draft.
  • 60 starting palettes. Five built in, plus 55 adapted from the community gallery at T3 Themes, each credited to its author. Filter by light or dark and load one into the draft.
  • Packs, not just colors. A pack combines the eight appearance colors with density, corner radius, typography, tool-card style, and an activity panel.
  • A designer agent. Ask for "a compact pack with mono text and bordered tool cards" and a real Paseo agent edits the draft through MCP tools. You review and activate.
  • Native chat components. Agents can publish interactive cards (buttons, inputs, selects, progress) inside their own chat, and react to what you press.
  • Nothing changes until you say so. Edits go to a draft. Only Activate applies it, and Revert brings the previous pack back.
Starting palettes Pack design Mobile preview

Install

Requires Paseo 0.9.2 through 0.12.x, including their betas, with plugins enabled, and Node.js on the daemon host.

paseo plugin install paseo-theme-studio

That installs the npm package. To follow the repository instead, use paseo plugin install https://github.com/Gabsplat/paseo-theme-studio.git.

Then open Theme Studio in the sidebar and choose Theme Studio · Live once in Settings → Appearance, so the active pack's palette applies across Paseo.

To work on the plugin, or to use code components and pack export (see Limitations), install it from a checkout instead:

git clone https://github.com/Gabsplat/paseo-theme-studio.git
cd paseo-theme-studio
pnpm install --frozen-lockfile
paseo plugin install "$PWD"

Quick start

  1. In Create, remix the current theme or start from an idea, and the designer returns takes you can try, remix again, or discard. Or open Packs and load a starting palette.
  2. In Colors, adjust the eight colors. Lock the ones you want to keep; presets, undo, and the designer leave locked colors alone. The contrast summary flags unreadable pairs.
  3. In Design, pick density, radius, fonts, tool-card style, and the activity panel. Hover a swatch under the preview to see where that color paints.
  4. Press Activate. The status next to the pack name shows whether the draft is live.
  5. Save pack keeps a named copy in your library. Star it to mark it as a favorite.

To let an agent do it, press Designer and describe what you want:

Make a warm, low-contrast dark pack with serif text and a Notes panel containing a short checklist.

The designer changes the draft only. It cannot activate a pack, unlock a color, or delete anything.

Components in agent chats

The Cards inspector holds reusable UI that agents can place in their timeline:

Every component is custom: React Native source that an agent designs for the job, or that you paste yourself. There are no pre-made blocks to assemble. A component appears in the chat exactly as designed, with no frame or title drawn around it, and it runs only after you read its source and activate the build.

A component can declare trigger rules such as "after a command fails, show this card", and connected agents publish it on their own when the rule matches. Pressing a button sends the event to the agent that owns the card, and the agent writes the result back into it. Connecting your other agents is opt-in, under Components → Connect your agents.

Agents can also show a live frame: interactive HTML they write on the spot, such as a chart or a calculator, that appears in the chat at once with no build or activation. It runs on Paseo web and desktop in a sandboxed frame with no network and follows the active theme. See docs/reference.md.

Export a pack as its own plugin

Export writes the current draft as an independent Paseo plugin, with its palette, panels, and tool-card renderers, and shows the command to install it. The exported plugin runs without Theme Studio.

Limitations

  • Code components and pack export typecheck generated source against React Native and the Paseo plugin SDK. Paseo installs plugins without development dependencies, so these two features need the checkout install above. Everything else works from any install.
  • Activated code components are written into the plugin's own directory, so a plugin update removes them. Their definitions stay in your library; build and activate them again.
  • Code components are trusted code running inside the plugin. The import checks are a filter, not a sandbox, which is why activation requires reviewing the source.
  • Packs style the palette, pack-owned components, completed shell tool cards, and the activity panel. Native chat messages, syntax highlighting, terminal ANSI colors, and Paseo's global layout stay under Paseo's control.
  • The preview replicates Paseo 0.9.2. Later versions can drift from it visually.
  • Tested on Linux daemons with the web and macOS clients. Windows is untested.

Documentation

  • Reference: packs, the designer and its MCP tools, the component library, triggers, revisions, and exports in detail.
  • Development: project layout, checks, and the end-to-end QA scripts.
pnpm typecheck
pnpm test
pnpm format:check

State lives in $PASEO_HOME/theme-studio (by default ~/.paseo/theme-studio), separate from the plugin's code.

Credits

  • The preview adapts the public visual structure and theme mappings of Paseo at v0.9.2. Theme Studio is not an official Paseo product.
  • The community palettes are adapted from T3 Themes (source), a gallery of community themes for T3 Code. Each one was reduced to Paseo's eight colors and keeps its author's name, shown in the Packs inspector and recorded in shared/community-presets.ts. Thanks to saltjsx, inovvia, jainvaibhav671, emmsixx, timvdhoorn, YanivZalach, itriibouanane, SunkenInTime, kototok903, njpatel, glarivie, D3OXY, pantharshit007, one-om-jha, vertopolkalf, Williawar, chadhs, PunGrumpy, MangMax, vkpdeveloper, and Just-Bax. If you made one of these and want it changed or removed, open an issue.
  • Well-known schemes such as Catppuccin, Dracula, Tokyo Night, Solarized, Kanagawa, and Rosé Pine belong to their original projects.

Licensed under Apache 2.0. See NOTICE.

Scanned 19 Oct 2026, 19:08 UTC from Gabsplat/paseo-theme-studio.