Skip to content

getuncaged/uncaged-themes

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Uncaged Themes [ ❯_ ]

The community theme gallery for Uncaged — the account-free, bring-your-own-model terminal.


A collection of color themes for the Uncaged terminal. Every theme is a small, human-readable YAML file — no build step, no account, nothing to install but the file itself.

Layout

themes/
├── system/      # Themes built by the Uncaged team (some inherited from Warp's
│                # open-source design). Curated, versioned with the app.
└── community/   # Themes contributed by everyone else. This is where your PR goes.
schema/
└── theme.schema.json   # JSON Schema describing the theme file format.
  • System themes ship inside Uncaged out of the box. This folder mirrors them so they can be browsed, diffed, and forked.
  • Community themes are contributed here by anyone. Uncaged can browse and install them, and the in-app theme editor can publish new ones straight to this folder via a pull request.

Use a theme

From the app (recommended). Open Settings → Appearance → Themes. Built-in system themes are always there; community themes can be browsed and installed from within Uncaged.

By hand. Copy any .yaml file from themes/ into your local themes folder and it shows up in the picker on next launch:

OS Themes folder
macOS / Linux ~/.uncaged/themes/
(create the folder if it doesn't exist)

If a theme uses a background_image, drop the image file next to the .yaml.

Make a theme

The fastest way is the in-app theme editor (Settings → Appearance → Themes → New theme): tweak colors, gradients, a background image, and transparency with a live preview, then hit Share to open a pre-filled pull request against this repo.

Prefer to write YAML by hand? Copy themes/community/_template.yaml — it documents every field — and see CONTRIBUTING.md.

The format in 20 seconds

name: My Theme
background: '#0e0d0c'          # solid color…
# background: { top: '#15110c', bottom: '#0c0a08' }   # …or a gradient
foreground: '#ece6dc'
accent: '#ff7a18'
cursor: '#ffce4e'             # optional
details: darker              # darker | lighter | a custom opacity block
terminal_colors:
  normal: { black: '#4a443b', red: '#ff6b5e', green: '#8fd46e', yellow: '#ffc24a',
            blue: '#74b4e0', magenta: '#f090c0', cyan: '#5fc9be', white: '#e9e1d4' }
  bright: { black: '#6e655a', red: '#ff8a76', green: '#b2e38c', yellow: '#ffd46e',
            blue: '#9bcbee', magenta: '#f7abd6', cyan: '#86ded0', white: '#fbf6ec' }

Full field reference: schema/theme.schema.json.

License

Theme files in this repository are released under the MIT License. By contributing a theme you agree to license it under the same terms.

About

Community theme gallery for Uncaged — the account-free, bring-your-own-model terminal.

Topics

Resources

License

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors