Web
Web projects get the Sosialoka look in one of two ways:
- React or Vue with shadcn: install your product’s theme, then the components, from the Sosialoka registry. Most products start here.
- Any other web app: load the CSS tokens, with or without Tailwind, and build on the variables.
Set up a shadcn project
Section titled “Set up a shadcn project”React components are built on Base UI and installed with shadcn; Vue components are built on Reka UI and installed with shadcn-vue. Both copy the source into your project, so you own the code.
- Start from a project where shadcn (React) or shadcn-vue (Vue) is already set up.
- Install the theme for your product. It writes the Sosialoka colors for light and dark mode, the fonts and the radius into your global CSS:
# Reactnpx shadcn@latest add https://design.sosialoka.tech/r/react/theme-coverclearance.json# Vuenpx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/theme-coverclearance.jsonSwap coverclearance for lokamusik, lokasign, mylokalink, or neutral for a screen that belongs to no product. A fresh shadcn project imports the Geist font; remove that import, since the theme sets Plus Jakarta Sans for text and headings. Installed a theme before? Install it again to get newer tokens such as overlay, which dialogs and sheets use.
- Install components from the Sosialoka registry, for example:
npx shadcn@latest add https://design.sosialoka.tech/r/react/button.jsonnpx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/button.json- Load Plus Jakarta Sans in your product. Turn on dark mode with the
.darkclass on the root element, as shadcn projects do; the theme writes its dark values under.dark.
Every component and its install command is listed in Components. Patterns show whole screens built from them.
Use the tokens without shadcn
Section titled “Use the tokens without shadcn”Set the product and the mode on the root element. data-brand is required; data-theme takes light or dark, and the .dark class works too. Without a dark marker, the light values apply.
<html data-brand="coverclearance" data-theme="dark">| File | Use it for |
|---|---|
| /tokens/sosialoka.css | Any web app. CSS variables for every theme and the tenant accent presets. |
| /tokens/tailwind.css | Tailwind v4. Maps the variables to utilities such as bg-primary, text-muted-foreground and rounded-md. |
| /tokens.json | Design tools and agents. Every token in the DTCG 2025.10 format. |
| /tokens/lokasign-light.json | Resolved values for one theme. Swap the file name for any other theme. |
In a Tailwind v4 project:
@import "tailwindcss";@import "./sosialoka.css";@import "./tailwind.css";Tokens name the fonts but don’t ship them. Load Plus Jakarta Sans for the interface and JetBrains Mono for code in your product.
Tenant accent
Section titled “Tenant accent”A page that takes a tenant’s or an artist’s color sets a preset on its own root element. Presets are blue, orange, teal and red.
<main data-tenant-accent="orange">Inside it, the tenant-accent tokens switch to the preset. Every other token keeps the product colors.
