Soren Design System

The library is built on top of MUI Core, so if you already know Material UI, you already know most of what you need here. Soren Design System wraps MUI with a shared theme, packaged colors, and conventions that keep every screen consistent.

What you get#

• React components — a Button and the rest of the MUI-based component set, ready to drop into your app.
• A theme provider — wrap your app once, and pass your own theme when you need to override the defaults.
• A colors package — Material Design color tokens available separately, at @getsoren/design-system/colors.
• A documented build and test workflow — Vite, Vitest, React Testing Library, Storybook, and Docker support out of the box.

Install it#

npm install @getsoren/design-system

See every package manager's command on the installation page.

Find your way around#

• Installation — install with npm, bun, yarn, or pnpm.
• Quickstart — render your first themed component.
• Theming — how ThemeProvider and custom themes work.
• Colors package — the standalone colors package.
• Local development — clone the repo and run it locally.
• Storybook — browse every component visually.
• Testing — how the library is tested.
• Contributing — how to send a pull request.
• Tech stack — what the library is built with.
• Package structure — how the repo is laid out.
• About Soren — who builds and uses this library.
• Changelog — what changed, release by release.
• License — ISC license details.