# Sosialoka Design System

> Tokens, components and patterns shared by Loka Musik, Cover Clearance, Lokasign and My Loka Link.

## Start

- [Sosialoka Design System](https://design.sosialoka.tech/index.md): Tokens, components and patterns shared by Loka Musik, Cover Clearance, Lokasign and My Loka Link.

## Develop

- [Web](https://design.sosialoka.tech/web.md): Set up a React, Vue or plain web project with the Sosialoka theme, tokens and components.
- [Flutter](https://design.sosialoka.tech/flutter.md): The sosialoka_ui package gives Flutter apps the Sosialoka themes for shadcn_ui and Material.
- [Use with AI agents](https://design.sosialoka.tech/ai-agents.md): Connect Claude Code, Cursor, VS Code, Codex or Gemini CLI to the design system through its MCP server, llms.txt, the registry and an AGENTS.md snippet.
- [Add a product](https://design.sosialoka.tech/add-a-product.md): Give a new Sosialoka product its own light and dark theme from its logo color with one command, and use the neutral theme when a screen belongs to no product.

## Brand

- [Brand](https://design.sosialoka.tech/brand.md): How Sosialoka products look like one family while each keeps its own name, logo and color.

## Foundations

- [Color](https://design.sosialoka.tech/foundations/color.md): Semantic color tokens for every theme, each product and the neutral theme in light and dark mode.
- [Typography](https://design.sosialoka.tech/foundations/typography.md): Three font layers and the UI type scale.
- [Icons](https://design.sosialoka.tech/foundations/icons.md): One icon set for every product, with fixed sizes, stroke and an action dictionary.
- [Spacing](https://design.sosialoka.tech/foundations/spacing.md): A 4px spacing scale for padding, gaps and page layout.
- [Radius](https://design.sosialoka.tech/foundations/radius.md): Corner radius for controls, cards and dialogs.
- [Elevation](https://design.sosialoka.tech/foundations/elevation.md): Three shadow levels; borders separate cards first.
- [Motion](https://design.sosialoka.tech/foundations/motion.md): Durations, easing curves and the login hero animation.

## Components

- [Components](https://design.sosialoka.tech/components.md): Sosialoka components for React and Vue, installed from the Sosialoka registry with the shadcn CLI.
- [Button](https://design.sosialoka.tech/components/button.md): Starts an action, such as saving a form or opening a dialog.
- [Input](https://design.sosialoka.tech/components/input.md): A single-line text field.
- [Input Group](https://design.sosialoka.tech/components/input-group.md): An input with buttons, icons or text attached.
- [Textarea](https://design.sosialoka.tech/components/textarea.md): A multi-line text field.
- [Label](https://design.sosialoka.tech/components/label.md): Names a form control and focuses it when clicked.
- [Field](https://design.sosialoka.tech/components/field.md): Puts a label, a hint and an error message around one form control.
- [Checkbox](https://design.sosialoka.tech/components/checkbox.md): Turns one option on or off.
- [Radio Group](https://design.sosialoka.tech/components/radio-group.md): Picks one option from a few that are all visible.
- [Switch](https://design.sosialoka.tech/components/switch.md): Turns a setting on or off right away.
- [Slider](https://design.sosialoka.tech/components/slider.md): Picks a value or a range on a track, such as where a preview starts and ends.
- [Toggle Group](https://design.sosialoka.tech/components/toggle-group.md): Chips that filter or switch a view; one or several can be on.
- [Select](https://design.sosialoka.tech/components/select.md): Picks one value from a short list.
- [Combobox](https://design.sosialoka.tech/components/combobox.md): Picks one value from a long list by typing to search it.
- [Calendar](https://design.sosialoka.tech/components/calendar.md): A month of days to pick a date from.
- [Date Picker](https://design.sosialoka.tech/components/date-picker.md): A button that opens a calendar and shows the chosen date.
- [Input OTP](https://design.sosialoka.tech/components/input-otp.md): Enters a one-time code in six boxes.
- [File Upload](https://design.sosialoka.tech/components/file-upload.md): Drops or picks files, then lists them with their size and upload progress.
- [Badge](https://design.sosialoka.tech/components/badge.md): Shows a status or a short label.
- [Alert](https://design.sosialoka.tech/components/alert.md): Shows a message that stays on the page, in a status color.
- [Card](https://design.sosialoka.tech/components/card.md): Groups related content on its own surface.
- [Carousel](https://design.sosialoka.tech/components/carousel.md): Slides through a row of cards, such as the latest releases.
- [Item](https://design.sosialoka.tech/components/item.md): A list row with media, a title, a description and actions.
- [Accordion](https://design.sosialoka.tech/components/accordion.md): Shows and hides sections of content one at a time.
- [Separator](https://design.sosialoka.tech/components/separator.md): A thin line between groups.
- [Tabs](https://design.sosialoka.tech/components/tabs.md): Switches between views of the same content.
- [Breadcrumb](https://design.sosialoka.tech/components/breadcrumb.md): Shows where a page sits and links back to its parents.
- [Stepper](https://design.sosialoka.tech/components/stepper.md): Shows the steps of a flow and the step you are on.
- [Timeline](https://design.sosialoka.tech/components/timeline.md): Lists what happened to a record, newest first.
- [Table](https://design.sosialoka.tech/components/table.md): Shows records in rows and columns, with the shared datatable layout and pagination.
- [Chart](https://design.sosialoka.tech/components/chart.md): Draws numbers over time or across categories, with a table of the same numbers.
- [Dialog](https://design.sosialoka.tech/components/dialog.md): Asks for a decision or input in a window over the page.
- [Alert Dialog](https://design.sosialoka.tech/components/alert-dialog.md): Confirms an action that cannot be undone.
- [Sheet](https://design.sosialoka.tech/components/sheet.md): A panel that slides in from the edge of the screen.
- [Drawer](https://design.sosialoka.tech/components/drawer.md): A bottom sheet that slides up on phones.
- [Popover](https://design.sosialoka.tech/components/popover.md): Shows extra content or a small form next to its trigger.
- [Dropdown Menu](https://design.sosialoka.tech/components/dropdown-menu.md): Lists actions behind one button.
- [Tooltip](https://design.sosialoka.tech/components/tooltip.md): Names an icon-only control on hover or focus.
- [Toast](https://design.sosialoka.tech/components/toast.md): Confirms an action with a short message that goes away.
- [Progress](https://design.sosialoka.tech/components/progress.md): Shows how far a task with a known length has come.
- [Spinner](https://design.sosialoka.tech/components/spinner.md): Shows that something is loading or saving.
- [Skeleton](https://design.sosialoka.tech/components/skeleton.md): A placeholder in the shape of content that is loading.
- [Avatar](https://design.sosialoka.tech/components/avatar.md): Shows a person or an artist as a picture or initials.
- [Sidebar](https://design.sosialoka.tech/components/sidebar.md): The main navigation of a dashboard.
- [Command](https://design.sosialoka.tech/components/command.md): Searches menus and records from the keyboard.

## Patterns

- [Login](https://design.sosialoka.tech/patterns/login.md): The sign-in page. A brand hero of chapters sits beside the form, which is signed "from Sosialoka".
- [Dashboard](https://design.sosialoka.tech/patterns/dashboard.md): The dashboard frame. It has a white sidebar, a floating header card with the search, icon actions and the account, and the content area.
- [Navigation menu](https://design.sosialoka.tech/patterns/navigation-menu.md): The sidebar menu of a product with many pages, with titled sections, sub menus that open in place, and counts.
- [Mobile app](https://design.sosialoka.tech/patterns/mobile-app.md): The phone app frame. It has a top bar with the title and search, the content, and a bottom nav of 3 to 5 destinations.
- [List](https://design.sosialoka.tech/patterns/list.md): A list page. It has stats, search and filters, a table with row actions, and pagination.
- [Responsive table](https://design.sosialoka.tech/patterns/responsive-table.md): A table on wide screens that turns into an accordion on phones, with every column and action still there.
- [Detail](https://design.sosialoka.tech/patterns/detail.md): A record page. It has the title with its status and main action, tabs, and label–value pairs.
- [Form](https://design.sosialoka.tech/patterns/form.md): A form. Labels sit above the fields, hints are one sentence, errors come from the backend, and the actions go in the footer.
- [Empty, loading and error](https://design.sosialoka.tech/patterns/states.md): What a page shows when there is nothing yet, while it loads, and when loading fails.
- [Notifications](https://design.sosialoka.tech/patterns/notifications.md): The bell panel and the notifications page. Unread comes first, categories are chips, and both use one row.
- [Artist page](https://design.sosialoka.tech/patterns/artist-page.md): The My Loka Link artist page. It is a 440px column with a hero and a call to action in the artist's accent.

## Content

- [Content](https://design.sosialoka.tech/content.md): How the copy in Sosialoka products reads. It uses "kamu", short active sentences, no legal terms, and error messages that come from the backend.
