Registration & Authentication

Create a BreakColorUI account to start building design systems

Why an account?

BreakColorUI saves every design system in your account: color palettes, typography, spacing, theme layout, and the Breakdance/Oxygen export. Signing in lets you switch devices, share the dashboard with your team's browser, and keep your settings synced with the Chrome Extension.

Cloud-saved projects

Every project — colors, typography, spacing, theme — lives in your account. No local files to lose.

Authentication by Clerk

Passwords, OAuth, and email verification are handled by Clerk — no custom auth in this app.

Free to start

The free plan saves 1 project with all features unlocked. Upgrade to Pro only when you need more.

What you can do with the free plan

  • 1 saved project with full access to colors, typography, spacing, theme, tokens, and CSS export
  • Chrome Extension sync for the active project
  • All features are functional — the free plan limits the number of projects, not what you can build with one

See the Billing & Plans guide for the full breakdown of free vs. Pro.

Sign-up methods

The sign-up form is rendered by Clerk and supports two paths. Pick whichever you prefer — both unlock the same dashboard.

Email & password

Standard email + password. Clerk sends a 6-digit verification code to your inbox before the account is created.

Continue with Google

One-click sign-up via your Google account. No password to manage and no email verification step.

Clerk sign-up form on /sign-up showing both Continue with Google button and email/password fields
Clerk sign-up form on /sign-up showing both Continue with Google button and email/password fields

Email verification is required

If you sign up with email + password, Clerk sends a verification code to that address. The account is not active until the code is entered. The email usually arrives within 1–2 minutes — check spam if it's missing.

How to sign up

Step by step

  1. Open /sign-up — the link is in the navbar (top right).
  2. Pick a method — "Continue with Google" or fill in email and password.
  3. Verify — enter the 6-digit code from your inbox (email path only).
  4. Land on the dashboard — Clerk redirects you to /dashboard and your Supabase user record is created automatically on first load.

What happens behind the scenes

The first time you land on the dashboard after signing up, BreakColorUI creates a matching record in its database (Supabase) so your projects can be linked to your Clerk account. This is automatic — there is no extra form to fill in.

Clerk holds the auth

Email, password, OAuth tokens, and session cookies are stored by Clerk — never by BreakColorUI.

Supabase holds the data

Your user row, projects, color palettes, and settings live in Supabase, keyed to your Clerk user ID.

Race-safe user creation

If you open the dashboard in two tabs at the same time on a brand-new account, BreakColorUI handles the duplicate insert gracefully — only one user record is created.

Signing in later

The sign-in page lives at /sign-in and uses the same methods. Clerk also handles password reset flows from that page if you forget your credentials.

Account, billing, and sign-out menu

Once signed in, click your avatar in the top-right of the navbar:

  • Manage account — opens Clerk's account modal (change email, password, profile, connected social accounts)
  • Billing — opens the Polar customer portal (or Stripe portal for legacy customers) — see Billing & Plans
  • Sign out — ends the session

Protected routes

Anything under /dashboard/* and /admin/* requires an authenticated session. If you visit those URLs while signed out, Clerk redirects you to /sign-in and brings you back after sign-in.

Next steps