create-mercato-app 0.4.2-canary-e5804f7db1

package/template/src/components/StartPageContent.tsx

@@ -0,0 +1,269 @@
+'use client'
+
+import React, { useState, type ReactNode } from 'react'
+import { Button } from '@/components/ui/button'
+import { Checkbox } from '@/components/ui/checkbox'
+import { Shield, Users, Briefcase, Info, Rocket, ArrowRight, BookOpen } from 'lucide-react'
+import { getApiDocsResources, resolveApiDocsBaseUrl } from '@open-mercato/core/modules/api_docs/lib/resources'
+import Link from 'next/link'
+import { useT } from '@open-mercato/shared/lib/i18n/context'
+
+interface RoleTileProps {
+  icon: ReactNode
+  title: string
+  description: string
+  features: string[]
+  loginUrl: string
+  variant?: 'default' | 'secondary' | 'outline'
+  disabled?: boolean
+  disabledCtaLabel?: string
+  disabledMessage?: ReactNode
+}
+
+function RoleTile({
+  icon,
+  title,
+  description,
+  features,
+  loginUrl,
+  variant = 'default',
+  disabled = false,
+  disabledCtaLabel,
+  disabledMessage,
+}: RoleTileProps) {
+  const t = useT()
+  const defaultDisabledCtaLabel = t('startPage.roleTile.loginUnavailable', 'Login unavailable')
+  return (
+    <div className="rounded-lg border bg-card p-6 flex flex-col gap-4 transition-all hover:shadow-md">
+      <div className="flex items-start gap-4">
+        <div className="rounded-lg bg-primary/10 p-3 text-primary">
+          {icon}
+        </div>
+        <div className="flex-1">
+          <h3 className="text-lg font-semibold">{title}</h3>
+          <p className="text-sm text-muted-foreground mt-1">{description}</p>
+        </div>
+      </div>
+      
+      <div className="flex-1">
+        <div className="text-xs font-medium text-muted-foreground mb-2">{t('startPage.roleTile.availableFeatures', 'Available Features:')}</div>
+        <ul className="space-y-1.5">
+          {features.map((feature, idx) => (
+            <li key={idx} className="text-sm flex items-start gap-2">
+              <span className="text-primary mt-0.5">•</span>
+              <span>{feature}</span>
+            </li>
+          ))}
+        </ul>
+      </div>
+
+      {disabled ? (
+        <>
+          <Button variant="outline" className="w-full cursor-not-allowed opacity-80" disabled>
+            {disabledCtaLabel ?? defaultDisabledCtaLabel}
+          </Button>
+          {disabledMessage ? (
+            <p className="text-xs text-muted-foreground text-center leading-relaxed">
+              {disabledMessage}
+            </p>
+          ) : null}
+        </>
+      ) : (
+        <Button asChild variant={variant} className="w-full">
+          <Link href={loginUrl}>{t('startPage.roleTile.loginAs', 'Login as {title}', { title })}</Link>
+        </Button>
+      )}
+    </div>
+  )
+}
+
+interface StartPageContentProps {
+  showStartPage: boolean
+  showOnboardingCta?: boolean
+}
+
+export function StartPageContent({ showStartPage: initialShowStartPage, showOnboardingCta = false }: StartPageContentProps) {
+  const t = useT()
+  const [showStartPage, setShowStartPage] = useState(initialShowStartPage)
+
+  const superAdminDisabled = showOnboardingCta
+  const apiDocs = getApiDocsResources()
+  const baseUrl = resolveApiDocsBaseUrl()
+
+  const handleCheckboxChange = (checked: boolean) => {
+    setShowStartPage(checked)
+    // Set cookie to remember preference
+    document.cookie = `show_start_page=${checked}; path=/; max-age=${365 * 24 * 60 * 60}; SameSite=Lax`
+  }
+
+  return (
+    <>
+      <section className="rounded-lg border bg-gradient-to-br from-background to-muted/20 p-8 text-center">
+        <h2 className="text-2xl font-semibold mb-3">{t('startPage.welcome.title', 'Welcome to Your Open Mercato Installation')}</h2>
+        <p className="text-muted-foreground max-w-2xl mx-auto">
+          {t('startPage.welcome.description', 'This is a customizable start page for your fresh Open Mercato installation. Choose your role below to get started and explore the features available to you.')}
+        </p>
+      </section>
+
+      {showOnboardingCta ? (
+        <section className="rounded-lg border border-emerald-300 bg-emerald-50 dark:border-emerald-800 dark:bg-emerald-950/20 p-6 md:p-8 flex flex-col md:flex-row md:items-center gap-6 shadow-sm">
+          <div className="flex items-start gap-4">
+            <div className="rounded-full bg-emerald-600 text-white p-3">
+              <Rocket className="size-6" />
+            </div>
+            <div className="space-y-3">
+              <div>
+                <h3 className="text-lg font-semibold text-emerald-900 dark:text-emerald-100">{t('startPage.onboarding.title', 'Launch your own workspace')}</h3>
+                <p className="text-sm text-emerald-800/80 dark:text-emerald-200/90">
+                  {t('startPage.onboarding.description', 'Create a tenant, organization, and administrator account in minutes. We\'ll verify your email and deliver a pre-seeded environment so you can explore Open Mercato with real data.')}
+                </p>
+              </div>
+              <ul className="text-sm text-emerald-900/80 dark:text-emerald-200/90 space-y-1 list-disc pl-5 marker:text-emerald-600 dark:marker:text-emerald-400">
+                <li>{t('startPage.onboarding.feature1', 'Automatic tenant and sample data provisioning')}</li>
+                <li>{t('startPage.onboarding.feature2', 'Ready-to-use superadmin credentials after verification')}</li>
+              </ul>
+            </div>
+          </div>
+          <div className="md:ml-auto">
+            <Button asChild className="bg-emerald-600 hover:bg-emerald-700 focus-visible:ring-emerald-600 px-6 py-5 text-base font-semibold text-white shadow-md">
+              <Link href="/onboarding">
+                {t('startPage.onboarding.cta', 'Start onboarding')}
+                <ArrowRight className="size-4" aria-hidden />
+              </Link>
+            </Button>
+          </div>
+        </section>
+      ) : null}
+
+      <section className="rounded-lg border bg-blue-50 dark:bg-blue-950/20 border-blue-200 dark:border-blue-900 p-4">
+        <div className="flex items-start gap-3">
+          <Info className="size-5 text-blue-600 dark:text-blue-400 shrink-0 mt-0.5" />
+          <div className="flex-1">
+            <h3 className="text-sm font-semibold text-blue-900 dark:text-blue-100 mb-1">{t('startPage.defaultPassword.title', 'Default Password')}</h3>
+            <p className="text-sm text-blue-800 dark:text-blue-200">
+              {t('startPage.defaultPassword.description1', 'The default password for all demo accounts is')}{' '}
+              <code className="px-1.5 py-0.5 rounded bg-blue-100 dark:bg-blue-900 font-mono text-xs">secret</code>.
+              {' '}{t('startPage.defaultPassword.description2', 'To change passwords, use the CLI command:')}{' '}
+              <code className="px-1.5 py-0.5 rounded bg-blue-100 dark:bg-blue-900 font-mono text-xs">yarn mercato auth set-password --email &lt;email&gt; --password &lt;newPassword&gt;</code>
+            </p>
+          </div>
+        </div>
+      </section>
+
+      <section>
+        <h2 className="text-xl font-semibold mb-4">{t('startPage.chooseRole.title', 'Choose Your Role')}</h2>
+        <div className="grid grid-cols-1 md:grid-cols-3 gap-6">
+          <RoleTile
+            icon={<Shield className="size-6" />}
+            title={t('startPage.roles.superAdmin.title', 'Super Admin')}
+            description={t('startPage.roles.superAdmin.description', 'Full system access with complete control')}
+            features={[
+              t('startPage.roles.superAdmin.feature1', 'Manage organization structure'),
+              t('startPage.roles.superAdmin.feature2', 'Create and manage roles'),
+              t('startPage.roles.superAdmin.feature3', 'Manage all users across organizations'),
+              t('startPage.roles.superAdmin.feature4', 'System-wide configuration'),
+              t('startPage.roles.superAdmin.feature5', 'Access to all modules and features')
+            ]}
+            loginUrl="/login?role=superadmin"
+            disabled={superAdminDisabled}
+            disabledCtaLabel={t('startPage.roles.superAdmin.disabledCta', 'Superadmin login disabled')}
+            disabledMessage={
+              <>
+                {t('startPage.roles.superAdmin.disabledMessage1', 'Superadmin demo access is not enabled on this instance.')}{' '}
+                {t('startPage.roles.superAdmin.disabledMessage2', 'Install Open Mercato locally for full access via')}{' '}
+                <a
+                  href="https://github.com/open-mercato"
+                  target="_blank"
+                  rel="noreferrer"
+                  className="underline hover:text-primary transition-colors"
+                >
+                  github.com/open-mercato
+                </a>
+                .
+              </>
+            }
+          />
+          
+          <RoleTile
+            icon={<Users className="size-6" />}
+            title={t('startPage.roles.admin.title', 'Admin')}
+            description={t('startPage.roles.admin.description', 'Organization-level administration')}
+            features={[
+              t('startPage.roles.admin.feature1', 'Admin specific organization(s)'),
+              t('startPage.roles.admin.feature2', 'Manage users within organization'),
+              t('startPage.roles.admin.feature3', 'Configure organization settings'),
+              t('startPage.roles.admin.feature4', 'Access to admin modules'),
+              t('startPage.roles.admin.feature5', 'Report and analytics access')
+            ]}
+            loginUrl="/login?role=admin"
+            variant="secondary"
+          />
+          
+          <RoleTile
+            icon={<Briefcase className="size-6" />}
+            title={t('startPage.roles.employee.title', 'Employee')}
+            description={t('startPage.roles.employee.description', 'Work on your daily tasks')}
+            features={[
+              t('startPage.roles.employee.feature1', 'Work on assigned tasks'),
+              t('startPage.roles.employee.feature2', 'Access organization resources'),
+              t('startPage.roles.employee.feature3', 'Collaborate with team members'),
+              t('startPage.roles.employee.feature4', 'View personal dashboard'),
+              t('startPage.roles.employee.feature5', 'Submit reports and updates')
+            ]}
+            loginUrl="/login?role=employee"
+            variant="outline"
+          />
+        </div>
+      </section>
+
+      <section className="rounded-lg border bg-card p-6 space-y-4">
+        <div className="flex flex-col gap-3 sm:flex-row sm:items-start sm:justify-between">
+          <div className="flex items-start gap-3">
+            <span className="rounded-full bg-primary/10 p-2 text-primary">
+              <BookOpen className="size-5" />
+            </span>
+            <div>
+              <h2 className="text-lg font-semibold">{t('startPage.apiResources.title', 'API resources')}</h2>
+              <p className="text-sm text-muted-foreground">
+                {t('startPage.apiResources.description', 'Explore the official documentation and download the generated OpenAPI exports for this installation.')}
+              </p>
+            </div>
+          </div>
+        </div>
+        <div className="grid gap-3 md:grid-cols-3">
+          {apiDocs.map((resource) => (
+            <a
+              key={resource.href}
+              href={resource.href}
+              target={resource.external ? '_blank' : undefined}
+              rel={resource.external ? 'noreferrer' : undefined}
+              className="rounded border bg-background p-4 text-sm transition hover:border-primary"
+            >
+              <div className="font-medium text-foreground">{resource.label}</div>
+              <p className="mt-1 text-xs text-muted-foreground">{resource.description}</p>
+              <span className="mt-3 inline-flex text-xs font-medium text-primary">{resource.actionLabel ?? t('startPage.apiResources.openLink', 'Open link')}</span>
+            </a>
+          ))}
+        </div>
+        <p className="text-xs text-muted-foreground">
+          {t('startPage.apiResources.baseUrl', 'Current API base URL:')}{' '}
+          <code className="rounded bg-muted px-2 py-0.5 text-[10px] text-foreground">{baseUrl}</code>
+        </p>
+      </section>
+
+      <section className="rounded-lg border p-4 flex items-center justify-center gap-3">
+        <Checkbox
+          id="show-start-page"
+          checked={showStartPage}
+          onCheckedChange={handleCheckboxChange}
+        />
+        <label
+          htmlFor="show-start-page"
+          className="text-sm font-medium leading-none peer-disabled:cursor-not-allowed peer-disabled:opacity-70 cursor-pointer"
+        >
+          {t('startPage.showNextTime', 'Display this start page next time')}
+        </label>
+      </section>
+    </>
+  )
+}

package/template/src/components/ui/button.tsx

@@ -0,0 +1,59 @@
+import * as React from "react"
+import { Slot } from "@radix-ui/react-slot"
+import { cva, type VariantProps } from "class-variance-authority"
+
+import { cn } from "@open-mercato/shared/lib/utils"
+
+const buttonVariants = cva(
+  "inline-flex items-center justify-center gap-2 whitespace-nowrap rounded-md text-sm font-medium transition-all disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-4 shrink-0 [&_svg]:shrink-0 outline-none focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px] aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive",
+  {
+    variants: {
+      variant: {
+        default:
+          "bg-primary text-primary-foreground shadow-xs hover:bg-primary/90",
+        destructive:
+          "bg-destructive text-white shadow-xs hover:bg-destructive/90 focus-visible:ring-destructive/20 dark:focus-visible:ring-destructive/40 dark:bg-destructive/60",
+        outline:
+          "border bg-background shadow-xs hover:bg-accent hover:text-accent-foreground dark:bg-input/30 dark:border-input dark:hover:bg-input/50",
+        secondary:
+          "bg-secondary text-secondary-foreground shadow-xs hover:bg-secondary/80",
+        ghost:
+          "hover:bg-accent hover:text-accent-foreground dark:hover:bg-accent/50",
+        link: "text-primary underline-offset-4 hover:underline",
+      },
+      size: {
+        default: "h-9 px-4 py-2 has-[>svg]:px-3",
+        sm: "h-8 rounded-md gap-1.5 px-3 has-[>svg]:px-2.5",
+        lg: "h-10 rounded-md px-6 has-[>svg]:px-4",
+        icon: "size-9",
+      },
+    },
+    defaultVariants: {
+      variant: "default",
+      size: "default",
+    },
+  }
+)
+
+function Button({
+  className,
+  variant,
+  size,
+  asChild = false,
+  ...props
+}: React.ComponentProps<"button"> &
+  VariantProps<typeof buttonVariants> & {
+    asChild?: boolean
+  }) {
+  const Comp = asChild ? Slot : "button"
+
+  return (
+    <Comp
+      data-slot="button"
+      className={cn(buttonVariants({ variant, size, className }))}
+      {...props}
+    />
+  )
+}
+
+export { Button, buttonVariants }

package/template/src/components/ui/card.tsx

@@ -0,0 +1,92 @@
+import * as React from "react"
+
+import { cn } from "@open-mercato/shared/lib/utils"
+
+function Card({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="card"
+      className={cn(
+        "bg-card text-card-foreground flex flex-col gap-6 rounded-xl border py-6 shadow-sm",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function CardHeader({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="card-header"
+      className={cn(
+        "@container/card-header grid auto-rows-min grid-rows-[auto_auto] items-start gap-1.5 px-6 has-data-[slot=card-action]:grid-cols-[1fr_auto] [.border-b]:pb-6",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function CardTitle({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="card-title"
+      className={cn("leading-none font-semibold", className)}
+      {...props}
+    />
+  )
+}
+
+function CardDescription({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="card-description"
+      className={cn("text-muted-foreground text-sm", className)}
+      {...props}
+    />
+  )
+}
+
+function CardAction({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="card-action"
+      className={cn(
+        "col-start-2 row-span-2 row-start-1 self-start justify-self-end",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function CardContent({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="card-content"
+      className={cn("px-6", className)}
+      {...props}
+    />
+  )
+}
+
+function CardFooter({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="card-footer"
+      className={cn("flex items-center px-6 [.border-t]:pt-6", className)}
+      {...props}
+    />
+  )
+}
+
+export {
+  Card,
+  CardHeader,
+  CardFooter,
+  CardTitle,
+  CardAction,
+  CardDescription,
+  CardContent,
+}

package/template/src/components/ui/checkbox.tsx

@@ -0,0 +1,29 @@
+import * as React from "react"
+import * as CheckboxPrimitive from "@radix-ui/react-checkbox"
+import { Check } from "lucide-react"
+
+import { cn } from "@open-mercato/shared/lib/utils"
+
+const Checkbox = React.forwardRef<
+  React.ElementRef<typeof CheckboxPrimitive.Root>,
+  React.ComponentPropsWithoutRef<typeof CheckboxPrimitive.Root>
+>(({ className, ...props }, ref) => (
+  <CheckboxPrimitive.Root
+    ref={ref}
+    className={cn(
+      "peer size-4 shrink-0 rounded-sm border border-input bg-background shadow-xs ring-offset-background focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:cursor-not-allowed disabled:opacity-50 data-[state=checked]:bg-primary data-[state=checked]:text-primary-foreground data-[state=checked]:border-primary",
+      className
+    )}
+    {...props}
+  >
+    <CheckboxPrimitive.Indicator
+      className={cn("flex items-center justify-center text-current")}
+    >
+      <Check className="size-3.5" />
+    </CheckboxPrimitive.Indicator>
+  </CheckboxPrimitive.Root>
+))
+Checkbox.displayName = CheckboxPrimitive.Root.displayName
+
+export { Checkbox }
+

package/template/src/components/ui/input.tsx

@@ -0,0 +1,21 @@
+import * as React from "react"
+
+import { cn } from "@open-mercato/shared/lib/utils"
+
+function Input({ className, type, ...props }: React.ComponentProps<"input">) {
+  return (
+    <input
+      type={type}
+      data-slot="input"
+      className={cn(
+        "file:text-foreground placeholder:text-muted-foreground selection:bg-primary selection:text-primary-foreground dark:bg-input/30 border-input flex h-9 w-full min-w-0 rounded-md border bg-transparent px-3 py-1 text-base shadow-xs transition-[color,box-shadow] outline-none file:inline-flex file:h-7 file:border-0 file:bg-transparent file:text-sm file:font-medium disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50 md:text-sm",
+        "focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px]",
+        "aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+export { Input }

package/template/src/components/ui/label.tsx

@@ -0,0 +1,24 @@
+"use client"
+
+import * as React from "react"
+import * as LabelPrimitive from "@radix-ui/react-label"
+
+import { cn } from "@open-mercato/shared/lib/utils"
+
+function Label({
+  className,
+  ...props
+}: React.ComponentProps<typeof LabelPrimitive.Root>) {
+  return (
+    <LabelPrimitive.Root
+      data-slot="label"
+      className={cn(
+        "flex items-center gap-2 text-sm leading-none font-medium select-none group-data-[disabled=true]:pointer-events-none group-data-[disabled=true]:opacity-50 peer-disabled:cursor-not-allowed peer-disabled:opacity-50",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+export { Label }

package/template/src/di.ts

@@ -0,0 +1,11 @@
+import type { AppContainer } from '@open-mercato/shared/lib/di/container'
+import { bootstrap } from '@open-mercato/core/bootstrap'
+
+// App-level DI overrides/registrations.
+// This runs after core defaults and module DI registrars.
+export async function register(container: AppContainer) {
+  // Call core bootstrap to setup eventBus and auto-register subscribers
+  // Feel free to remove or customize this for your app needs
+  await bootstrap(container)
+  // App-level overrides can follow here
+}