Skip to content

Design system

Skimbyte's UI is built from a small set of shared tokens and reusable components, all cataloged in the designsheet — a standalone, runnable style guide.

The designsheet

Every shared design token and reusable component has a catalog entry. The designsheet is a real app (Navigation 3, adaptive list-detail layout) that builds for desktop and the web:

./gradlew :designsheet:run                        # desktop
./gradlew :designsheet:wasmJsBrowserDevelopmentRun # web (dev server)

A deployed build is browsable at designsheet/ on this site.

Contribution rule

Any new or changed shared component or token must be reflected in the designsheet in the same change — the catalog is the source of truth for what exists, and it is what keeps the system honest.

Principles

  • Theme: Material 3 Expressive (MaterialExpressiveTheme with spring-based motion), with both color schemes specified role-by-role from Skimbyte's own warm ramps rather than layered onto Material's baseline. Dark is the default.
  • No hardcoded values: colors, shapes, and type always come from MaterialTheme / shared tokens — components never embed raw hex values or dp-sized text styles.
  • Stateless components: every reusable composable takes (state, callbacks) and hoists all state; each has light + dark @Previews.
  • Screenshot-tested: shared components carry Roborazzi goldens, so any pixel change is a reviewed diff, not a surprise.

Brand assets

The icon and wordmark SVGs live in docs/branding/ and are the single source every platform icon is generated from (Android mipmaps + adaptive vectors, iOS asset catalog, desktop .icns/.ico/.png, web favicons).