Skip to content

Web

Download .md

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.

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.

  1. Start from a project where shadcn (React) or shadcn-vue (Vue) is already set up.
  2. 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:
Terminal window
# React
npx shadcn@latest add https://design.sosialoka.tech/r/react/theme-coverclearance.json
# Vue
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/theme-coverclearance.json

Swap 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.

  1. Install components from the Sosialoka registry, for example:
Terminal window
npx shadcn@latest add https://design.sosialoka.tech/r/react/button.json
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/button.json
  1. Load Plus Jakarta Sans in your product. Turn on dark mode with the .dark class 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.

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.

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.