# Web

> Set up a React, Vue or plain web project with the Sosialoka theme, tokens and components.

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

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:

```bash
# 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.

3. Install components from the Sosialoka registry, for example:

```bash
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
```

4. 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](https://design.sosialoka.tech/components/). [Patterns](https://design.sosialoka.tech/patterns/login/) show whole screens built from them.

## 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. Offer Light, Dark and Auto, with Auto (the device's setting) as the start; see the mode rule in [Dashboard](https://design.sosialoka.tech/patterns/dashboard/#rules).

```html
<html data-brand="coverclearance" data-theme="dark">
```

| File | Use it for |
| --- | --- |
| [/tokens/sosialoka.css](https://design.sosialoka.tech/tokens/sosialoka.css) | Any web app. CSS variables for every theme and the tenant accent presets. |
| [/tokens/tailwind.css](https://design.sosialoka.tech/tokens/tailwind.css) | Tailwind v4. Maps the variables to utilities such as `bg-primary`, `text-muted-foreground` and `rounded-md`. |
| [/tokens.json](https://design.sosialoka.tech/tokens.json) | Design tools and agents. Every token in the DTCG 2025.10 format. |
| [/tokens/lokasign-light.json](https://design.sosialoka.tech/tokens/lokasign-light.json) | Resolved values for one theme. Swap the file name for any other theme. |

In a Tailwind v4 project:

```css
@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

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

```html
<main data-tenant-accent="orange">
```

Inside it, the `tenant-accent` tokens switch to the preset. Every other token keeps the product colors.
