create-ej-app 25.0.0 → 27.0.0

package/template/saas-starter/src/components/ui/sonner.tsx

@@ -0,0 +1,45 @@
+'use client'
+
+import {
+  CircleCheckIcon,
+  InfoIcon,
+  Loader2Icon,
+  OctagonXIcon,
+  TriangleAlertIcon
+} from 'lucide-react'
+import { useTheme } from 'next-themes'
+import { Toaster as Sonner, type ToasterProps } from 'sonner'
+
+const Toaster = ({ ...props }: ToasterProps) => {
+  const { theme = 'system' } = useTheme()
+
+  return (
+    <Sonner
+      theme={theme as ToasterProps['theme']}
+      className="toaster group"
+      icons={{
+        success: <CircleCheckIcon className="size-4" />,
+        info: <InfoIcon className="size-4" />,
+        warning: <TriangleAlertIcon className="size-4" />,
+        error: <OctagonXIcon className="size-4" />,
+        loading: <Loader2Icon className="size-4 animate-spin" />
+      }}
+      style={
+        {
+          '--normal-bg': 'var(--popover)',
+          '--normal-text': 'var(--popover-foreground)',
+          '--normal-border': 'var(--border)',
+          '--border-radius': 'var(--radius)'
+        } as React.CSSProperties
+      }
+      toastOptions={{
+        classNames: {
+          toast: 'cn-toast'
+        }
+      }}
+      {...props}
+    />
+  )
+}
+
+export { Toaster }

package/template/saas-starter/src/components/ui/switch.tsx

@@ -0,0 +1,33 @@
+'use client'
+
+import { Switch as SwitchPrimitive } from 'radix-ui'
+import * as React from 'react'
+
+import { cn } from '~/lib/cn'
+
+function Switch({
+  className,
+  size = 'default',
+  ...props
+}: React.ComponentProps<typeof SwitchPrimitive.Root> & {
+  size?: 'sm' | 'default'
+}) {
+  return (
+    <SwitchPrimitive.Root
+      data-slot="switch"
+      data-size={size}
+      className={cn(
+        'peer group/switch focus-visible:border-ring focus-visible:ring-ring/50 aria-invalid:border-destructive aria-invalid:ring-destructive/20 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 data-checked:bg-primary data-unchecked:bg-input dark:data-unchecked:bg-input/80 relative inline-flex shrink-0 items-center rounded-full border border-transparent shadow-xs transition-all outline-none after:absolute after:-inset-x-3 after:-inset-y-2 focus-visible:ring-3 aria-invalid:ring-3 data-disabled:cursor-not-allowed data-disabled:opacity-50 data-[size=default]:h-[18.4px] data-[size=default]:w-[32px] data-[size=sm]:h-[14px] data-[size=sm]:w-[24px]',
+        className
+      )}
+      {...props}
+    >
+      <SwitchPrimitive.Thumb
+        data-slot="switch-thumb"
+        className="bg-background dark:data-checked:bg-primary-foreground dark:data-unchecked:bg-foreground pointer-events-none block rounded-full ring-0 transition-transform group-data-[size=default]/switch:size-4 group-data-[size=sm]/switch:size-3 group-data-[size=default]/switch:data-checked:translate-x-[calc(100%-2px)] group-data-[size=sm]/switch:data-checked:translate-x-[calc(100%-2px)] group-data-[size=default]/switch:data-unchecked:translate-x-0 group-data-[size=sm]/switch:data-unchecked:translate-x-0"
+      />
+    </SwitchPrimitive.Root>
+  )
+}
+
+export { Switch }

package/template/saas-starter/src/components/ui/table.tsx

@@ -0,0 +1,116 @@
+'use client'
+
+import * as React from 'react'
+
+import { cn } from '~/lib/cn'
+
+function Table({ className, ...props }: React.ComponentProps<'table'>) {
+  return (
+    <div
+      data-slot="table-container"
+      className="relative w-full overflow-x-auto"
+    >
+      <table
+        data-slot="table"
+        className={cn('w-full caption-bottom text-sm', className)}
+        {...props}
+      />
+    </div>
+  )
+}
+
+function TableHeader({ className, ...props }: React.ComponentProps<'thead'>) {
+  return (
+    <thead
+      data-slot="table-header"
+      className={cn('[&_tr]:border-b', className)}
+      {...props}
+    />
+  )
+}
+
+function TableBody({ className, ...props }: React.ComponentProps<'tbody'>) {
+  return (
+    <tbody
+      data-slot="table-body"
+      className={cn('[&_tr:last-child]:border-0', className)}
+      {...props}
+    />
+  )
+}
+
+function TableFooter({ className, ...props }: React.ComponentProps<'tfoot'>) {
+  return (
+    <tfoot
+      data-slot="table-footer"
+      className={cn(
+        'bg-muted/50 border-t font-medium [&>tr]:last:border-b-0',
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function TableRow({ className, ...props }: React.ComponentProps<'tr'>) {
+  return (
+    <tr
+      data-slot="table-row"
+      className={cn(
+        'hover:bg-muted/50 has-aria-expanded:bg-muted/50 data-[state=selected]:bg-muted border-b transition-colors',
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function TableHead({ className, ...props }: React.ComponentProps<'th'>) {
+  return (
+    <th
+      data-slot="table-head"
+      className={cn(
+        'text-foreground h-10 px-2 text-left align-middle font-medium whitespace-nowrap [&:has([role=checkbox])]:pr-0',
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function TableCell({ className, ...props }: React.ComponentProps<'td'>) {
+  return (
+    <td
+      data-slot="table-cell"
+      className={cn(
+        'p-2 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0',
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function TableCaption({
+  className,
+  ...props
+}: React.ComponentProps<'caption'>) {
+  return (
+    <caption
+      data-slot="table-caption"
+      className={cn('text-muted-foreground mt-4 text-sm', className)}
+      {...props}
+    />
+  )
+}
+
+export {
+  Table,
+  TableBody,
+  TableCaption,
+  TableCell,
+  TableFooter,
+  TableHead,
+  TableHeader,
+  TableRow
+}

package/template/saas-starter/src/components/ui/tabs.tsx

@@ -0,0 +1,90 @@
+'use client'
+
+import { cva, type VariantProps } from 'class-variance-authority'
+import { Tabs as TabsPrimitive } from 'radix-ui'
+import * as React from 'react'
+
+import { cn } from '~/lib/cn'
+
+function Tabs({
+  className,
+  orientation = 'horizontal',
+  ...props
+}: React.ComponentProps<typeof TabsPrimitive.Root>) {
+  return (
+    <TabsPrimitive.Root
+      data-slot="tabs"
+      data-orientation={orientation}
+      className={cn(
+        'group/tabs flex gap-2 data-horizontal:flex-col',
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+const tabsListVariants = cva(
+  'group/tabs-list inline-flex w-fit items-center justify-center rounded-lg p-[3px] text-muted-foreground group-data-horizontal/tabs:h-9 group-data-vertical/tabs:h-fit group-data-vertical/tabs:flex-col data-[variant=line]:rounded-none',
+  {
+    variants: {
+      variant: {
+        default: 'bg-muted',
+        line: 'gap-1 bg-transparent'
+      }
+    },
+    defaultVariants: {
+      variant: 'default'
+    }
+  }
+)
+
+function TabsList({
+  className,
+  variant = 'default',
+  ...props
+}: React.ComponentProps<typeof TabsPrimitive.List> &
+  VariantProps<typeof tabsListVariants>) {
+  return (
+    <TabsPrimitive.List
+      data-slot="tabs-list"
+      data-variant={variant}
+      className={cn(tabsListVariants({ variant }), className)}
+      {...props}
+    />
+  )
+}
+
+function TabsTrigger({
+  className,
+  ...props
+}: React.ComponentProps<typeof TabsPrimitive.Trigger>) {
+  return (
+    <TabsPrimitive.Trigger
+      data-slot="tabs-trigger"
+      className={cn(
+        "text-foreground/60 hover:text-foreground focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:outline-ring dark:text-muted-foreground dark:hover:text-foreground relative inline-flex h-[calc(100%-1px)] flex-1 items-center justify-center gap-1.5 rounded-md border border-transparent px-2 py-1 text-sm font-medium whitespace-nowrap transition-all group-data-vertical/tabs:w-full group-data-vertical/tabs:justify-start focus-visible:ring-[3px] focus-visible:outline-1 disabled:pointer-events-none disabled:opacity-50 has-data-[icon=inline-end]:pr-1.5 has-data-[icon=inline-start]:pl-1.5 group-data-[variant=default]/tabs-list:data-active:shadow-sm group-data-[variant=line]/tabs-list:data-active:shadow-none [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
+        'group-data-[variant=line]/tabs-list:bg-transparent group-data-[variant=line]/tabs-list:data-active:bg-transparent dark:group-data-[variant=line]/tabs-list:data-active:border-transparent dark:group-data-[variant=line]/tabs-list:data-active:bg-transparent',
+        'data-active:bg-background data-active:text-foreground dark:data-active:border-input dark:data-active:bg-input/30 dark:data-active:text-foreground',
+        'after:bg-foreground after:absolute after:opacity-0 after:transition-opacity group-data-horizontal/tabs:after:inset-x-0 group-data-horizontal/tabs:after:bottom-[-5px] group-data-horizontal/tabs:after:h-0.5 group-data-vertical/tabs:after:inset-y-0 group-data-vertical/tabs:after:-right-1 group-data-vertical/tabs:after:w-0.5 group-data-[variant=line]/tabs-list:data-active:after:opacity-100',
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function TabsContent({
+  className,
+  ...props
+}: React.ComponentProps<typeof TabsPrimitive.Content>) {
+  return (
+    <TabsPrimitive.Content
+      data-slot="tabs-content"
+      className={cn('flex-1 text-sm outline-none', className)}
+      {...props}
+    />
+  )
+}
+
+export { Tabs, TabsContent, TabsList, tabsListVariants, TabsTrigger }

package/template/saas-starter/src/components/ui/textarea.tsx

@@ -0,0 +1,18 @@
+import * as React from 'react'
+
+import { cn } from '~/lib/cn'
+
+function Textarea({ className, ...props }: React.ComponentProps<'textarea'>) {
+  return (
+    <textarea
+      data-slot="textarea"
+      className={cn(
+        'border-input placeholder:text-muted-foreground focus-visible:border-ring focus-visible:ring-ring/50 aria-invalid:border-destructive aria-invalid:ring-destructive/20 dark:bg-input/30 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 flex field-sizing-content min-h-16 w-full rounded-md border bg-transparent px-2.5 py-2 text-base shadow-xs transition-[color,box-shadow] outline-none focus-visible:ring-3 disabled:cursor-not-allowed disabled:opacity-50 aria-invalid:ring-3 md:text-sm',
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+export { Textarea }

package/template/saas-starter/src/components/ui/tooltip.tsx

@@ -0,0 +1,57 @@
+'use client'
+
+import { Tooltip as TooltipPrimitive } from 'radix-ui'
+import * as React from 'react'
+
+import { cn } from '~/lib/cn'
+
+function TooltipProvider({
+  delayDuration = 0,
+  ...props
+}: React.ComponentProps<typeof TooltipPrimitive.Provider>) {
+  return (
+    <TooltipPrimitive.Provider
+      data-slot="tooltip-provider"
+      delayDuration={delayDuration}
+      {...props}
+    />
+  )
+}
+
+function Tooltip({
+  ...props
+}: React.ComponentProps<typeof TooltipPrimitive.Root>) {
+  return <TooltipPrimitive.Root data-slot="tooltip" {...props} />
+}
+
+function TooltipTrigger({
+  ...props
+}: React.ComponentProps<typeof TooltipPrimitive.Trigger>) {
+  return <TooltipPrimitive.Trigger data-slot="tooltip-trigger" {...props} />
+}
+
+function TooltipContent({
+  className,
+  sideOffset = 0,
+  children,
+  ...props
+}: React.ComponentProps<typeof TooltipPrimitive.Content>) {
+  return (
+    <TooltipPrimitive.Portal>
+      <TooltipPrimitive.Content
+        data-slot="tooltip-content"
+        sideOffset={sideOffset}
+        className={cn(
+          'bg-foreground text-background data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 data-[state=delayed-open]:animate-in data-[state=delayed-open]:fade-in-0 data-[state=delayed-open]:zoom-in-95 data-open:animate-in data-open:fade-in-0 data-open:zoom-in-95 data-closed:animate-out data-closed:fade-out-0 data-closed:zoom-out-95 z-50 inline-flex w-fit max-w-xs origin-(--radix-tooltip-content-transform-origin) items-center gap-1.5 rounded-md px-3 py-1.5 text-xs has-data-[slot=kbd]:pr-1.5 **:data-[slot=kbd]:relative **:data-[slot=kbd]:isolate **:data-[slot=kbd]:z-50 **:data-[slot=kbd]:rounded-sm',
+          className
+        )}
+        {...props}
+      >
+        {children}
+        <TooltipPrimitive.Arrow className="bg-foreground fill-foreground z-50 size-2.5 translate-y-[calc(-50%_-_2px)] rotate-45 rounded-[2px]" />
+      </TooltipPrimitive.Content>
+    </TooltipPrimitive.Portal>
+  )
+}
+
+export { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger }

package/template/saas-starter/src/components/user-menu.tsx

@@ -0,0 +1,213 @@
+'use client'
+
+import {
+  House,
+  LayoutGrid,
+  LogOut,
+  ShieldCheck,
+  Ticket,
+  UserCog,
+  UserX
+} from 'lucide-react'
+import Link from 'next/link'
+import { usePathname, useRouter } from 'next/navigation'
+import { useState } from 'react'
+import { ThemeToggle } from '~/components/theme-toggle'
+import { Avatar, AvatarFallback, AvatarImage } from '~/components/ui/avatar'
+import { Button } from '~/components/ui/button'
+import {
+  DropdownMenu,
+  DropdownMenuContent,
+  DropdownMenuGroup,
+  DropdownMenuItem,
+  DropdownMenuLabel,
+  DropdownMenuSeparator,
+  DropdownMenuTrigger
+} from '~/components/ui/dropdown-menu'
+import { admin, signOut } from '~/lib/auth-client'
+import { cn } from '~/lib/cn'
+
+type UserMenuProps = {
+  user: {
+    name?: string | null
+    email?: string | null
+    image?: string | null
+  }
+  fallbackName?: string
+  fallbackInitials?: string
+  wrapperClassName?: string
+  /** Superadmins work in both panels, so they get a way to cross over. */
+  isSuperAdmin?: boolean
+  /** This session is an admin acting as someone else. */
+  isImpersonating?: boolean
+}
+
+export function UserMenu({
+  user,
+  fallbackName = 'Unknown',
+  fallbackInitials = 'NA',
+  wrapperClassName = 'flex items-center gap-2',
+  isSuperAdmin = false,
+  isImpersonating = false
+}: UserMenuProps) {
+  const router = useRouter()
+  const pathname = usePathname()
+  const [isStopping, setIsStopping] = useState(false)
+
+  // One entry, pointing at the panel you are not in. Account pages sit outside
+  // both, and lead back to the admin panel.
+  const inAdminPanel = pathname?.startsWith('/admin') ?? false
+  const switchTo = inAdminPanel
+    ? { href: '/app', label: 'Switch to App', Icon: LayoutGrid }
+    : { href: '/admin', label: 'Switch to Admin', Icon: ShieldCheck }
+
+  const displayName = user.name ?? fallbackName
+  const initials =
+    user.name
+      ?.split(' ')
+      .slice(0, 2)
+      .map(part => part[0])
+      .join('') || fallbackInitials
+
+  async function stopImpersonating() {
+    setIsStopping(true)
+    try {
+      await admin.stopImpersonating()
+      // Back to the admin panel: the restored session may have no access to the
+      // organization page the impersonated user was looking at.
+      router.push('/admin')
+      router.refresh()
+    } catch {
+      setIsStopping(false)
+    }
+  }
+
+  return (
+    <div className={wrapperClassName}>
+      <ThemeToggle />
+      <DropdownMenu>
+        <DropdownMenuTrigger asChild>
+          <Button
+            variant="ghost"
+            className="relative size-8 rounded-full"
+            aria-label={
+              isImpersonating
+                ? `Account menu, impersonating ${displayName}`
+                : 'Account menu'
+            }
+          >
+            <Avatar
+              className={cn(
+                'size-8',
+                isImpersonating &&
+                  'ring-warning ring-offset-background ring-2 ring-offset-2'
+              )}
+            >
+              <AvatarFallback className="text-foreground">
+                {initials}
+              </AvatarFallback>
+              {user.image ? (
+                <AvatarImage src={user.image} alt={displayName} />
+              ) : null}
+            </Avatar>
+            {isImpersonating ? (
+              <span className="bg-warning text-warning-foreground ring-background absolute -right-0.5 -bottom-0.5 flex size-3.5 items-center justify-center rounded-full ring-2">
+                <UserX className="size-2.5" aria-hidden="true" />
+              </span>
+            ) : null}
+          </Button>
+        </DropdownMenuTrigger>
+        <DropdownMenuContent className="w-60" align="end" forceMount>
+          <DropdownMenuLabel className="font-normal">
+            <div className="flex flex-col space-y-1">
+              <p className="text-foreground text-sm leading-none font-medium">
+                {displayName}
+              </p>
+              <p className="text-muted-foreground text-xs leading-none">
+                {user.email ?? ''}
+              </p>
+            </div>
+          </DropdownMenuLabel>
+
+          {isImpersonating ? (
+            <>
+              <DropdownMenuSeparator />
+              <div className="border-warning/40 bg-warning/10 mx-1 mb-1 flex items-start gap-2 rounded-md border px-2 py-1.5">
+                <UserX
+                  className="text-warning mt-0.5 size-3.5 shrink-0"
+                  aria-hidden="true"
+                />
+                <p className="text-foreground text-xs leading-snug">
+                  You are signed in as this user. Anything you do is recorded
+                  against their account.
+                </p>
+              </div>
+              <DropdownMenuGroup>
+                <DropdownMenuItem
+                  variant="destructive"
+                  disabled={isStopping}
+                  onSelect={event => {
+                    // Hold the menu open while the session swaps back.
+                    event.preventDefault()
+                    void stopImpersonating()
+                  }}
+                >
+                  <UserX className="mr-2 size-4" />
+                  <span>{isStopping ? 'Stopping…' : 'Stop Impersonating'}</span>
+                </DropdownMenuItem>
+              </DropdownMenuGroup>
+            </>
+          ) : null}
+
+          {isSuperAdmin ? (
+            <>
+              <DropdownMenuSeparator />
+              <DropdownMenuGroup>
+                <DropdownMenuItem asChild>
+                  <Link href={switchTo.href}>
+                    <switchTo.Icon className="mr-2 size-4" />
+                    <span>{switchTo.label}</span>
+                  </Link>
+                </DropdownMenuItem>
+              </DropdownMenuGroup>
+            </>
+          ) : null}
+
+          <DropdownMenuSeparator />
+          <DropdownMenuGroup>
+            <DropdownMenuItem asChild>
+              <Link href="/">
+                <House className="mr-2 size-4" />
+                <span>Home</span>
+              </Link>
+            </DropdownMenuItem>
+            <DropdownMenuItem asChild>
+              <Link href="/profile">
+                <UserCog className="mr-2 size-4" />
+                <span>Profile</span>
+              </Link>
+            </DropdownMenuItem>
+            <DropdownMenuItem asChild>
+              <Link href="/support">
+                <Ticket className="mr-2 size-4" />
+                <span>Support</span>
+              </Link>
+            </DropdownMenuItem>
+          </DropdownMenuGroup>
+          <DropdownMenuSeparator />
+          <DropdownMenuGroup>
+            <DropdownMenuItem
+              onClick={async () => {
+                await signOut()
+                router.push('/login')
+              }}
+            >
+              <LogOut className="mr-2 size-4" />
+              <span>Log Out</span>
+            </DropdownMenuItem>
+          </DropdownMenuGroup>
+        </DropdownMenuContent>
+      </DropdownMenu>
+    </div>
+  )
+}

package/template/saas-starter/src/db/common.ts

@@ -0,0 +1,63 @@
+/**
+ * @fileoverview Reusable Drizzle column definitions shared across tables.
+ *
+ * Centralises common patterns (prefixed CUID primary keys, timestamps) so
+ * every table stays consistent.
+ */
+import { createId } from '@paralleldrive/cuid2'
+import { sql } from 'drizzle-orm'
+import {
+  boolean,
+  check,
+  timestamp,
+  varchar,
+  type AnyPgColumn
+} from 'drizzle-orm/pg-core'
+
+export const commonFieldDefs = {
+  /** Generates a prefixed CUID2 primary key, such as `user_clx1234567890`. */
+  id: (prefix: string) =>
+    varchar('id')
+      .primaryKey()
+      .$defaultFn(() => prefix + '_' + createId()),
+  /** Nullable timezone-aware timestamp column. */
+  date: (name: string) =>
+    timestamp(name, {
+      mode: 'date',
+      withTimezone: true
+    }),
+  /** Auto-populated `created_at` and `updated_at` timestamp pair. */
+  dates: {
+    createdAt: timestamp('created_at', {
+      mode: 'date',
+      withTimezone: true
+    })
+      .notNull()
+      .defaultNow(),
+    updatedAt: timestamp('updated_at', {
+      mode: 'date',
+      withTimezone: true
+    })
+      .notNull()
+      .$onUpdate(() => sql`NOW()`)
+      .defaultNow()
+  },
+  /** Boolean `is_active` flag, defaults to `true`. */
+  isActive: boolean('is_active').notNull().default(true)
+}
+
+/**
+ * CHECK constraint holding every listed column at zero or above.
+ *
+ * Invariants belong in the database, not only in Zod: the seed script, a
+ * `psql` session, and Drizzle Studio all write around Zod. Nullable columns
+ * still pass, since a CHECK rejects only a definitively false result.
+ */
+export const nonNegativeCheck = (name: string, columns: AnyPgColumn[]) =>
+  check(
+    name,
+    sql.join(
+      columns.map(column => sql`${column} >= 0`),
+      sql` AND `
+    )
+  )

package/template/saas-starter/src/db/enums.ts

@@ -0,0 +1,50 @@
+/**
+ * @fileoverview Postgres enum definitions. Each constant maps to a
+ * `CREATE TYPE ... AS ENUM` referenced by columns in `schema.ts`.
+ *
+ * @module db/enums
+ */
+import { pgEnum } from 'drizzle-orm/pg-core'
+
+// ─── Billing ────────────────────────────────────────────────────
+
+export const organizationSubscriptionPlanEnum = pgEnum(
+  'organization_subscription_plan_enum',
+  ['free', 'pro', 'ultimate']
+)
+
+/** Stripe's subscription statuses, plus `free` for organizations without one. */
+export const organizationSubscriptionStatusEnum = pgEnum(
+  'organization_subscription_status_enum',
+  [
+    'incomplete',
+    'incomplete_expired',
+    'trialing',
+    'active',
+    'past_due',
+    'canceled',
+    'unpaid',
+    'paused',
+    'free'
+  ]
+)
+
+export const organizationSubscriptionIntervalEnum = pgEnum(
+  'organization_subscription_interval_enum',
+  ['month', 'year']
+)
+
+// ─── Support ────────────────────────────────────────────────────
+
+export const supportTicketStatusEnum = pgEnum('support_ticket_status_enum', [
+  'open',
+  'in_progress',
+  'waiting_customer',
+  'resolved',
+  'closed'
+])
+
+export const supportTicketPriorityEnum = pgEnum(
+  'support_ticket_priority_enum',
+  ['low', 'medium', 'high', 'urgent']
+)