Dashboard

apps/dashboard is the merchant admin application. Merchants sign in, select an active organization (their store), and manage products, orders, customers, payment integrations, and custom domains.

Port: 3002 · Framework: Next.js 16 · Auth: Better Auth + organization plugin

Architecture

Most data operations go through the Commerce API. Integration credentials and domain records are managed directly via Drizzle (encrypted at rest).

Features

Auth & organization

Merchants authenticate with email/password. Better Auth's organization plugin enables multi-store management:

• Registration creates a user + first organization
• session.activeOrganizationId determines which store's data is shown
• Organization switching updates the active org in the session
• All admin API calls are scoped to the active organization

// lib/admin.ts
export async function withActiveOrg<T>(fn: (orgId: string) => Promise<T>) {
  const orgId = await requireActiveOrg()
  return withTenant(orgId, fn)
}

Navigation

Sidebar groups defined in lib/nav.ts:

Configuration

Related pages