Faircamp Manual


With this you can adjust the visual appearance of your faircamp site.

Note that the theme applies across all pages - customizations on individual pages are not available.


# theme

base: light

This sets the overall tone, think of it as a base preset. Choose from:

If you don't set a base theme, the current default is dark.

Detail color adjustments

# theme

link_hue: 13
link_saturation: 100
link_lightness: 75
tint_back: 50
tint_front: 10
text_hue: 89

The link color can be set through link_hue (0-360), link_lightness (0-100) and link_saturation (0-100) - make sure to pick a color that clearly differs from regular text and is easily readable against the site's background.

If you increase tint_back (0-100), the link color will give a color tone to the entire page (except for the black/white base themes, one does not simply tone black/white). Similarly, tint_front applies color tinting to regular text, but the hue for this comes from text_hue (not from link_hue).

Note that there is a --theming-widget CLI option that lets you interactively explore these detail settings. Just build your catalog with the option enabled and every page will then contain the theming widget (don't forget to turn it off before deployment).

Background image

The previously described settings are (link color aside) mostly harmless: No matter the settings, your site will stay readable. Not so with this option. A background image can lend a nice quality to your site design, but choose carefully what image you use and how opaque you make it. Sharp details and strong contrasts within the image and against the text of the site will render the site hard to read or even unreadable. That said, background_image lets you reference the image to use, and with background_alpha (0-100) you can optionally control its opaqueness.

# theme

background_alpha: 23
background_image: squiggly_monsters_texture.jpg

Round corners on release covers

To give a softer feel to your page, enable the round_corners option. This will visually round off the corners of covers on all pages.

# theme


Disabling relative waveform lengths

By default, the width of each track's waveform on a release page will render at a different length, reflecting the duration of the track in relation to the longest track on the release - for instance if the longest track on a release is about two minutes long, that one will span the full width, but another track that is only about one minute long will span only half of that width. If you publish releases whose tracks have wildly varying lengths, shorter tracks might get very narrow in the interface. If this is a concern to you, or you just generally want all tracks to be full-width as an aesthetic choice, you can enable this alternative behavior with this flag:

# theme


Disabling waveforms altogether

This will render all waveforms simply as flat lines.

# theme



By default, faircamp bundles and uses the Barlow font on a generated site, but this can be configured.

Using the standard sans serif font from the system of the visitor:

# theme

system_font: sans

Using the standard monospace font from the system of the visitor:

# theme

system_font: mono

Using a specific font (by font name) from the system of the visitor (this should have a rather specific reason, normally you probably don't want to do that):

# theme

system_font: Arial

Bundling and using a custom font (put a .woff or .woff2 file in the same directory as the manifest - other font file types are not supported!):

# theme

custom_font: MyCustomSans.woff2
Next page: Localization