starter-themes

Theme management for TanStack Start apps. Light, dark and system themes with no flash of the wrong theme, system-preference tracking, and cross-tab sync.

Layout

• packages/starter-themes — the starter-themes npm package. See its README for installation and full API docs.
• www — the showcase website, itself a TanStack Start app using starter-themes.

Development

pnpm install
pnpm dev        # build the package, then run the site in dev mode
pnpm build      # build everything
pnpm check      # oxlint + oxfmt --check
pnpm check:fix  # autofix lint + formatting
pnpm typecheck

Releasing

Versioning is managed with changesets:

pnpm changeset       # describe the change (after any user-facing package change)
pnpm release         # bump versions + update CHANGELOG from pending changesets
pnpm pub:release     # publish to npm (manual, from a maintainer machine)

License

MIT