Themes

A theme changes how LaForge looks: its colours, faces and shapes, and where things sit on the screen. Every theme draws both light and dark, and the light/dark button picks the mode under whichever theme you use. Two themes come built in; more install from collections or from any GitHub repository, in one command or from the Themes panel.

A theme holds no code. It is a folder of stylesheets, fonts and images with a small skin.json manifest; the forge refuses any other kind of file, serves each one with its own content type and a sandboxing policy, and loads nothing from the network. Theme and skin mean the same thing; the command line says la skin ….

Choose one#

In the browser, the Themes button (the palette icon at the top right, or Themes… in ⌘K) opens a side panel. Pick a theme to use it in that browser at once, without a reload; Make forge default sets what other browsers see until they pick their own; Remove takes an installed theme out of the forge. Get more browses a collection and installs from it, Add a collection takes a GitHub link, and Install from a link takes a folder path or a repository.

From a terminal:

la skin list                  # the themes the forge has, and its default
la skin browse official       # what a collection offers
la skin install official/bridge
la skin use bridge            # make it the forge's default

The themes#

Classic and Console come with LaForge. The seven official themes are released with it and install with la skin install official/<name>, or all of them with la skin install official.

Collections#

A collection is a place to get themes: a GitHub repository holding one theme or many. Two come with LaForge, and you can add any other by its link.

CollectionWhat it is
officialThe themes released with LaForge, from the skins/ folder of RunOutcome/laforge.
libraryMore themes, from the community, in RunOutcome/laforge-skins. Pull requests are welcome.
any repositoryAdd it by link and browse it like the others.
la skin collections                                   # the collections the forge knows
la skin collections add https://github.com/you/your-skins
la skin browse your-skins                             # what it offers, installed ones marked
la skin install your-skins/NAME                       # one; or your-skins for all
la skin collections remove your-skins                 # its installed themes stay

You can also install straight from a repository or a folder, without adding a collection: la skin install you/skins, la skin install you/skins@v2, la skin install https://github.com/you/skins or la skin install ./my-theme. Whatever it downloads, nothing runs: each theme passes the same checks as a folder. la skin update reinstalls themes from where they came.

Make your own. A theme is two files: a manifest and a stylesheet. The tutorial goes from an empty folder to a working theme in light and dark in under fifteen minutes.

Make a theme