npm - @beignet/cli - Versions diffs - 0.0.3 → 0.0.5 - Mend

@beignet/cli 0.0.3 → 0.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (138) hide show

package/CHANGELOG.md +219 -0
package/README.md +379 -61
package/dist/ansi.d.ts +10 -0
package/dist/ansi.d.ts.map +1 -0
package/dist/ansi.js +20 -0
package/dist/ansi.js.map +1 -0
package/dist/choices.d.ts +49 -0
package/dist/choices.d.ts.map +1 -0
package/dist/choices.js +53 -0
package/dist/choices.js.map +1 -0
package/dist/completion.d.ts +47 -0
package/dist/completion.d.ts.map +1 -0
package/dist/completion.js +123 -0
package/dist/completion.js.map +1 -0
package/dist/config.d.ts +8 -0
package/dist/config.d.ts.map +1 -1
package/dist/config.js +8 -0
package/dist/config.js.map +1 -1
package/dist/create-prompts.d.ts +41 -0
package/dist/create-prompts.d.ts.map +1 -0
package/dist/create-prompts.js +78 -0
package/dist/create-prompts.js.map +1 -0
package/dist/create.d.ts +10 -5
package/dist/create.d.ts.map +1 -1
package/dist/create.js +28 -47
package/dist/create.js.map +1 -1
package/dist/db.d.ts +1 -0
package/dist/db.d.ts.map +1 -1
package/dist/db.js +37 -2
package/dist/db.js.map +1 -1
package/dist/github-annotations.d.ts +18 -0
package/dist/github-annotations.d.ts.map +1 -0
package/dist/github-annotations.js +22 -0
package/dist/github-annotations.js.map +1 -0
package/dist/index.d.ts +1 -9
package/dist/index.d.ts.map +1 -1
package/dist/index.js +665 -603
package/dist/index.js.map +1 -1
package/dist/inspect.d.ts +21 -2
package/dist/inspect.d.ts.map +1 -1
package/dist/inspect.js +1938 -131
package/dist/inspect.js.map +1 -1
package/dist/lib.d.ts +20 -0
package/dist/lib.d.ts.map +1 -0
package/dist/lib.js +17 -0
package/dist/lib.js.map +1 -0
package/dist/lint.d.ts +10 -1
package/dist/lint.d.ts.map +1 -1
package/dist/lint.js +340 -33
package/dist/lint.js.map +1 -1
package/dist/make.d.ts +20 -3
package/dist/make.d.ts.map +1 -1
package/dist/make.js +1896 -382
package/dist/make.js.map +1 -1
package/dist/outbox.d.ts +24 -0
package/dist/outbox.d.ts.map +1 -0
package/dist/outbox.js +138 -0
package/dist/outbox.js.map +1 -0
package/dist/schedule.d.ts +36 -0
package/dist/schedule.d.ts.map +1 -0
package/dist/schedule.js +155 -0
package/dist/schedule.js.map +1 -0
package/dist/task.d.ts +26 -0
package/dist/task.d.ts.map +1 -0
package/dist/task.js +106 -0
package/dist/task.js.map +1 -0
package/dist/templates/base.d.ts +13 -0
package/dist/templates/base.d.ts.map +1 -0
package/dist/templates/base.js +300 -0
package/dist/templates/base.js.map +1 -0
package/dist/templates/db.d.ts +14 -0
package/dist/templates/db.d.ts.map +1 -0
package/dist/templates/db.js +962 -0
package/dist/templates/db.js.map +1 -0
package/dist/templates/index.d.ts +14 -0
package/dist/templates/index.d.ts.map +1 -0
package/dist/templates/index.js +123 -0
package/dist/templates/index.js.map +1 -0
package/dist/templates/server.d.ts +26 -0
package/dist/templates/server.d.ts.map +1 -0
package/dist/templates/server.js +520 -0
package/dist/templates/server.js.map +1 -0
package/dist/templates/shadcn.d.ts +5 -0
package/dist/templates/shadcn.d.ts.map +1 -0
package/dist/templates/shadcn.js +555 -0
package/dist/templates/shadcn.js.map +1 -0
package/dist/templates/shared.d.ts +49 -0
package/dist/templates/shared.d.ts.map +1 -0
package/dist/templates/shared.js +57 -0
package/dist/templates/shared.js.map +1 -0
package/dist/templates/shell.d.ts +5 -0
package/dist/templates/shell.d.ts.map +1 -0
package/dist/templates/shell.js +1190 -0
package/dist/templates/shell.js.map +1 -0
package/dist/templates/todos.d.ts +17 -0
package/dist/templates/todos.d.ts.map +1 -0
package/dist/templates/todos.js +607 -0
package/dist/templates/todos.js.map +1 -0
package/dist/version.d.ts +8 -0
package/dist/version.d.ts.map +1 -0
package/dist/version.js +18 -0
package/dist/version.js.map +1 -0
package/package.json +9 -8
package/src/ansi.ts +30 -0
package/src/choices.ts +83 -0
package/src/completion.ts +169 -0
package/src/config.ts +16 -0
package/src/create-prompts.ts +114 -0
package/src/create.ts +40 -64
package/src/db.ts +60 -4
package/src/github-annotations.ts +37 -0
package/src/index.ts +1075 -817
package/src/inspect.ts +2859 -115
package/src/lib.ts +45 -0
package/src/lint.ts +493 -39
package/src/make.ts +2389 -406
package/src/outbox.ts +249 -0
package/src/schedule.ts +272 -0
package/src/task.ts +169 -0
package/src/templates/base.ts +377 -0
package/src/templates/db.ts +963 -0
package/src/templates/index.ts +148 -0
package/src/templates/server.ts +528 -0
package/src/templates/shadcn.ts +570 -0
package/src/templates/shared.ts +90 -0
package/src/templates/shell.ts +1219 -0
package/src/templates/todos.ts +607 -0
package/src/version.ts +20 -0
package/dist/create-bin.d.ts +0 -3
package/dist/create-bin.d.ts.map +0 -1
package/dist/create-bin.js +0 -9
package/dist/create-bin.js.map +0 -1
package/dist/templates.d.ts +0 -55
package/dist/templates.d.ts.map +0 -1
package/dist/templates.js +0 -3520
package/dist/templates.js.map +0 -1
package/src/create-bin.ts +0 -11
package/src/templates.ts +0 -3774

package/src/templates/shell.ts ADDED Viewed

@@ -0,0 +1,1219 @@
+import {
+  packageRunner,
+  type TemplateContext,
+  type TemplateFile,
+} from "./shared.js";
+/**
+ * Application shell for generated apps: root layout and providers, public
+ * landing page, auth pages, the authenticated sidebar shell, settings pages,
+ * the typed client setup, and the shadcn-styled todos worked example.
+ *
+ * These templates assume the shadcn stack from `shadcn.ts` is installed
+ * alongside them.
+ */
+const appProviders = `"use client";
+import { QueryClientProvider } from "@tanstack/react-query";
+import { type ReactNode, useState } from "react";
+import { makeQueryClient } from "@/client";
+export function Providers({ children }: { children: ReactNode }) {
+	const [queryClient] = useState(() => makeQueryClient());
+	return (
+		<QueryClientProvider client={queryClient}>{children}</QueryClientProvider>
+	);
+}
+`;
+const rootLayout = `import "./globals.css";
+import type { Metadata } from "next";
+import type { ReactNode } from "react";
+import { ThemeProvider } from "@/components/theme-provider";
+import { Providers } from "./providers";
+export const metadata: Metadata = {
+	title: "Beignet app",
+	description: "A contract-first Next.js app.",
+};
+export default function RootLayout({ children }: { children: ReactNode }) {
+	return (
+		<html lang="en" suppressHydrationWarning>
+			<body>
+				<ThemeProvider
+					attribute="class"
+					defaultTheme="system"
+					enableSystem
+					disableTransitionOnChange
+				>
+					<Providers>{children}</Providers>
+				</ThemeProvider>
+			</body>
+		</html>
+	);
+}
+`;
+const landingPage = `import Link from "next/link";
+import { Button } from "@/components/ui/button";
+export default function HomePage() {
+	return (
+		<main className="flex min-h-svh flex-col">
+			<header className="flex items-center justify-between px-6 py-4">
+				<span className="font-heading text-sm font-semibold">Beignet app</span>
+				<nav className="flex items-center gap-2" aria-label="Account">
+					<Button asChild variant="ghost">
+						<Link href="/sign-in">Sign in</Link>
+					</Button>
+					<Button asChild>
+						<Link href="/sign-up">Create account</Link>
+					</Button>
+				</nav>
+			</header>
+			<section className="flex flex-1 flex-col items-center justify-center px-6 py-16 text-center">
+				<p className="text-[13px] font-bold tracking-[0.12em] text-primary uppercase">
+					Beignet starter
+				</p>
+				<h1 className="mt-3 max-w-xl font-heading text-4xl font-semibold tracking-tight">
+					Type-safe full-stack workflows without codegen.
+				</h1>
+				<p className="mt-4 max-w-lg text-muted-foreground">
+					Contracts, use cases, ports, a typed client, React Query, and form
+					validation are wired together so you can start shipping product code
+					immediately.
+				</p>
+				<div className="mt-8 flex gap-3">
+					<Button asChild size="lg">
+						<Link href="/sign-up">Get started</Link>
+					</Button>
+					<Button asChild size="lg" variant="outline">
+						<Link href="/sign-in">Sign in</Link>
+					</Button>
+				</div>
+				<nav
+					className="mt-10 flex gap-5 text-sm text-muted-foreground"
+					aria-label="Starter links"
+				>
+					<a className="hover:text-foreground" href="/api/health">
+						Health
+					</a>
+					<a className="hover:text-foreground" href="/api/openapi">
+						OpenAPI
+					</a>
+					<a className="hover:text-foreground" href="https://beignetjs.com">
+						Docs
+					</a>
+				</nav>
+			</section>
+		</main>
+	);
+}
+`;
+const authLayout = `import type { ReactNode } from "react";
+export default function AuthLayout({ children }: { children: ReactNode }) {
+	return (
+		<main className="flex min-h-svh items-center justify-center bg-muted/40 p-6">
+			<div className="w-full max-w-sm">{children}</div>
+		</main>
+	);
+}
+`;
+const signInPage = `"use client";
+import { rootFormError } from "@beignet/react-hook-form";
+import Link from "next/link";
+import { useRouter } from "next/navigation";
+import { useForm } from "react-hook-form";
+import { authClient } from "@/client/auth-client";
+import { Button } from "@/components/ui/button";
+import {
+	Card,
+	CardContent,
+	CardDescription,
+	CardHeader,
+	CardTitle,
+} from "@/components/ui/card";
+import { Input } from "@/components/ui/input";
+import { Label } from "@/components/ui/label";
+type SignInValues = {
+	email: string;
+	password: string;
+};
+export default function SignInPage() {
+	const router = useRouter();
+	const form = useForm<SignInValues>({
+		defaultValues: { email: "", password: "" },
+	});
+	const onSubmit = form.handleSubmit(async (values) => {
+		form.clearErrors("root");
+		const result = await authClient.signIn.email({
+			email: values.email,
+			password: values.password,
+		});
+		if (result.error) {
+			form.setError(
+				"root",
+				rootFormError(result.error, result.error.message || "Could not sign in."),
+			);
+			return;
+		}
+		router.push("/dashboard");
+		router.refresh();
+	});
+	return (
+		<Card>
+			<CardHeader>
+				<CardTitle>Sign in</CardTitle>
+				<CardDescription>Welcome back. Enter your details below.</CardDescription>
+			</CardHeader>
+			<CardContent>
+				<form className="flex flex-col gap-4" onSubmit={onSubmit}>
+					<div className="flex flex-col gap-2">
+						<Label htmlFor="email">Email</Label>
+						<Input
+							id="email"
+							type="email"
+							autoComplete="email"
+							placeholder="you@example.com"
+							required
+							{...form.register("email")}
+						/>
+					</div>
+					<div className="flex flex-col gap-2">
+						<Label htmlFor="password">Password</Label>
+						<Input
+							id="password"
+							type="password"
+							autoComplete="current-password"
+							required
+							{...form.register("password")}
+						/>
+					</div>
+					{form.formState.errors.root ? (
+						<p className="text-sm text-destructive">
+							{form.formState.errors.root.message}
+						</p>
+					) : null}
+					<Button type="submit" disabled={form.formState.isSubmitting}>
+						{form.formState.isSubmitting ? "Signing in..." : "Sign in"}
+					</Button>
+				</form>
+				<p className="mt-4 text-center text-sm text-muted-foreground">
+					No account yet?{" "}
+					<Link
+						className="text-foreground underline underline-offset-4"
+						href="/sign-up"
+					>
+						Create one
+					</Link>
+				</p>
+			</CardContent>
+		</Card>
+	);
+}
+`;
+const signUpPage = `"use client";
+import { rootFormError } from "@beignet/react-hook-form";
+import Link from "next/link";
+import { useRouter } from "next/navigation";
+import { useForm } from "react-hook-form";
+import { authClient } from "@/client/auth-client";
+import { Button } from "@/components/ui/button";
+import {
+	Card,
+	CardContent,
+	CardDescription,
+	CardHeader,
+	CardTitle,
+} from "@/components/ui/card";
+import { Input } from "@/components/ui/input";
+import { Label } from "@/components/ui/label";
+type SignUpValues = {
+	name: string;
+	email: string;
+	password: string;
+};
+export default function SignUpPage() {
+	const router = useRouter();
+	const form = useForm<SignUpValues>({
+		defaultValues: { name: "", email: "", password: "" },
+	});
+	const onSubmit = form.handleSubmit(async (values) => {
+		form.clearErrors("root");
+		const result = await authClient.signUp.email({
+			name: values.name,
+			email: values.email,
+			password: values.password,
+		});
+		if (result.error) {
+			form.setError(
+				"root",
+				rootFormError(
+					result.error,
+					result.error.message || "Could not create your account.",
+				),
+			);
+			return;
+		}
+		router.push("/dashboard");
+		router.refresh();
+	});
+	return (
+		<Card>
+			<CardHeader>
+				<CardTitle>Create account</CardTitle>
+				<CardDescription>Start building in a few seconds.</CardDescription>
+			</CardHeader>
+			<CardContent>
+				<form className="flex flex-col gap-4" onSubmit={onSubmit}>
+					<div className="flex flex-col gap-2">
+						<Label htmlFor="name">Name</Label>
+						<Input
+							id="name"
+							autoComplete="name"
+							placeholder="Ada Lovelace"
+							required
+							{...form.register("name")}
+						/>
+					</div>
+					<div className="flex flex-col gap-2">
+						<Label htmlFor="email">Email</Label>
+						<Input
+							id="email"
+							type="email"
+							autoComplete="email"
+							placeholder="you@example.com"
+							required
+							{...form.register("email")}
+						/>
+					</div>
+					<div className="flex flex-col gap-2">
+						<Label htmlFor="password">Password</Label>
+						<Input
+							id="password"
+							type="password"
+							autoComplete="new-password"
+							minLength={8}
+							required
+							{...form.register("password")}
+						/>
+					</div>
+					{form.formState.errors.root ? (
+						<p className="text-sm text-destructive">
+							{form.formState.errors.root.message}
+						</p>
+					) : null}
+					<Button type="submit" disabled={form.formState.isSubmitting}>
+						{form.formState.isSubmitting ? "Creating account..." : "Create account"}
+					</Button>
+				</form>
+				<p className="mt-4 text-center text-sm text-muted-foreground">
+					Already have an account?{" "}
+					<Link
+						className="text-foreground underline underline-offset-4"
+						href="/sign-in"
+					>
+						Sign in
+					</Link>
+				</p>
+			</CardContent>
+		</Card>
+	);
+}
+`;
+const appLayout = `import { headers } from "next/headers";
+import { redirect } from "next/navigation";
+import type { ReactNode } from "react";
+import { AppSidebar } from "@/components/app-sidebar";
+import { auth } from "@/lib/better-auth";
+import { isDevtoolsEnabled } from "@/lib/env";
+export default async function AppLayout({ children }: { children: ReactNode }) {
+	const session = await auth.api.getSession({ headers: await headers() });
+	if (!session) {
+		redirect("/sign-in");
+	}
+	return (
+		<div className="flex min-h-svh">
+			<AppSidebar
+				user={{ name: session.user.name, email: session.user.email }}
+				showDevtools={isDevtoolsEnabled}
+				showOpenapi={true}
+			/>
+			<main className="flex-1">
+				<div className="mx-auto w-full max-w-3xl px-6 py-8">{children}</div>
+			</main>
+		</div>
+	);
+}
+`;
+function dashboardPage(ctx: TemplateContext): string {
+  return `import { headers } from "next/headers";
+import Link from "next/link";
+import {
+	Card,
+	CardContent,
+	CardDescription,
+	CardHeader,
+	CardTitle,
+} from "@/components/ui/card";
+import { auth } from "@/lib/better-auth";
+export default async function DashboardPage() {
+	const session = await auth.api.getSession({ headers: await headers() });
+	const name = session?.user.name ?? "there";
+	return (
+		<div className="flex flex-col gap-6">
+			<div className="flex flex-col gap-1">
+				<h1 className="font-heading text-xl font-semibold">Welcome, {name}</h1>
+				<p className="text-sm text-muted-foreground">
+					Your app is running. Here is where to go next.
+				</p>
+			</div>
+			<div className="grid gap-4 sm:grid-cols-2">
+				<Link href="/todos" className="group">
+					<Card className="h-full transition-shadow group-hover:ring-foreground/20">
+						<CardHeader>
+							<CardTitle>Manage your todos</CardTitle>
+							<CardDescription>
+								The worked example: a contract-backed API with a typed client,
+								React Query, and form validation.
+							</CardDescription>
+						</CardHeader>
+					</Card>
+				</Link>
+				<Card>
+					<CardHeader>
+						<CardTitle>Next steps</CardTitle>
+						<CardDescription>Make this starter your own.</CardDescription>
+					</CardHeader>
+					<CardContent className="flex flex-col gap-2 text-sm">
+						<code className="rounded-lg bg-muted px-2 py-1.5 font-mono text-xs">
+							${packageRunner(ctx)} make feature
+						</code>
+						<p className="text-muted-foreground">
+							Scaffold your next feature, then read the docs at{" "}
+							<a
+								className="text-foreground underline underline-offset-4"
+								href="https://beignetjs.com"
+							>
+								beignetjs.com
+							</a>
+							.
+						</p>
+					</CardContent>
+				</Card>
+			</div>
+		</div>
+	);
+}
+`;
+}
+const todosPage = `import { TodoApp } from "@/features/todos/components/todo-app";
+export default function TodosPage() {
+	return (
+		<div className="flex flex-col gap-6">
+			<div className="flex flex-col gap-1">
+				<h1 className="font-heading text-xl font-semibold">Todos</h1>
+				<p className="text-sm text-muted-foreground">
+					A contract-backed feature with a typed client, React Query, and form
+					validation.
+				</p>
+			</div>
+			<TodoApp />
+		</div>
+	);
+}
+`;
+const settingsLayout = `import type { ReactNode } from "react";
+import { SettingsNav } from "@/components/settings-nav";
+export default function SettingsLayout({ children }: { children: ReactNode }) {
+	return (
+		<div className="flex flex-col gap-6">
+			<div className="flex flex-col gap-1">
+				<h1 className="font-heading text-xl font-semibold">Settings</h1>
+				<p className="text-sm text-muted-foreground">
+					Manage your account and app preferences.
+				</p>
+			</div>
+			<SettingsNav />
+			{children}
+		</div>
+	);
+}
+`;
+const settingsProfilePage = `"use client";
+import { rootFormError } from "@beignet/react-hook-form";
+import { useState } from "react";
+import { useForm } from "react-hook-form";
+import { authClient } from "@/client/auth-client";
+import { Button } from "@/components/ui/button";
+import {
+	Card,
+	CardContent,
+	CardDescription,
+	CardHeader,
+	CardTitle,
+} from "@/components/ui/card";
+import { Input } from "@/components/ui/input";
+import { Label } from "@/components/ui/label";
+type ProfileValues = {
+	name: string;
+	email: string;
+};
+export default function SettingsProfilePage() {
+	const session = authClient.useSession();
+	const [saved, setSaved] = useState(false);
+	const form = useForm<ProfileValues>({
+		defaultValues: { name: "", email: "" },
+		values: {
+			name: session.data?.user.name ?? "",
+			email: session.data?.user.email ?? "",
+		},
+	});
+	const onSubmit = form.handleSubmit(async (values) => {
+		form.clearErrors("root");
+		setSaved(false);
+		const updated = await authClient.updateUser({ name: values.name });
+		if (updated.error) {
+			form.setError(
+				"root",
+				rootFormError(
+					updated.error,
+					updated.error.message || "Could not update your profile.",
+				),
+			);
+			return;
+		}
+		if (values.email !== session.data?.user.email) {
+			const changed = await authClient.changeEmail({ newEmail: values.email });
+			if (changed.error) {
+				form.setError(
+					"root",
+					rootFormError(
+						changed.error,
+						changed.error.message || "Could not change your email.",
+					),
+				);
+				return;
+			}
+		}
+		await session.refetch();
+		setSaved(true);
+	});
+	return (
+		<Card>
+			<CardHeader>
+				<CardTitle>Profile</CardTitle>
+				<CardDescription>Update your name and email address.</CardDescription>
+			</CardHeader>
+			<CardContent>
+				<form className="flex max-w-sm flex-col gap-4" onSubmit={onSubmit}>
+					<div className="flex flex-col gap-2">
+						<Label htmlFor="name">Name</Label>
+						<Input
+							id="name"
+							autoComplete="name"
+							required
+							{...form.register("name")}
+						/>
+					</div>
+					<div className="flex flex-col gap-2">
+						<Label htmlFor="email">Email</Label>
+						<Input
+							id="email"
+							type="email"
+							autoComplete="email"
+							required
+							{...form.register("email")}
+						/>
+					</div>
+					{form.formState.errors.root ? (
+						<p className="text-sm text-destructive">
+							{form.formState.errors.root.message}
+						</p>
+					) : null}
+					<div className="flex items-center gap-3">
+						<Button type="submit" disabled={form.formState.isSubmitting}>
+							{form.formState.isSubmitting ? "Saving..." : "Save changes"}
+						</Button>
+						{saved ? (
+							<p className="text-sm text-muted-foreground">Saved.</p>
+						) : null}
+					</div>
+				</form>
+			</CardContent>
+		</Card>
+	);
+}
+`;
+const settingsPasswordPage = `"use client";
+import { rootFormError } from "@beignet/react-hook-form";
+import { useState } from "react";
+import { useForm } from "react-hook-form";
+import { authClient } from "@/client/auth-client";
+import { Button } from "@/components/ui/button";
+import {
+	Card,
+	CardContent,
+	CardDescription,
+	CardHeader,
+	CardTitle,
+} from "@/components/ui/card";
+import { Input } from "@/components/ui/input";
+import { Label } from "@/components/ui/label";
+type PasswordValues = {
+	currentPassword: string;
+	newPassword: string;
+};
+export default function SettingsPasswordPage() {
+	const [saved, setSaved] = useState(false);
+	const form = useForm<PasswordValues>({
+		defaultValues: { currentPassword: "", newPassword: "" },
+	});
+	const onSubmit = form.handleSubmit(async (values) => {
+		form.clearErrors("root");
+		setSaved(false);
+		const result = await authClient.changePassword({
+			currentPassword: values.currentPassword,
+			newPassword: values.newPassword,
+			revokeOtherSessions: true,
+		});
+		if (result.error) {
+			form.setError(
+				"root",
+				rootFormError(
+					result.error,
+					result.error.message || "Could not change your password.",
+				),
+			);
+			return;
+		}
+		form.reset();
+		setSaved(true);
+	});
+	return (
+		<Card>
+			<CardHeader>
+				<CardTitle>Password</CardTitle>
+				<CardDescription>
+					Changing your password signs you out everywhere else.
+				</CardDescription>
+			</CardHeader>
+			<CardContent>
+				<form className="flex max-w-sm flex-col gap-4" onSubmit={onSubmit}>
+					<div className="flex flex-col gap-2">
+						<Label htmlFor="current-password">Current password</Label>
+						<Input
+							id="current-password"
+							type="password"
+							autoComplete="current-password"
+							required
+							{...form.register("currentPassword")}
+						/>
+					</div>
+					<div className="flex flex-col gap-2">
+						<Label htmlFor="new-password">New password</Label>
+						<Input
+							id="new-password"
+							type="password"
+							autoComplete="new-password"
+							minLength={8}
+							required
+							{...form.register("newPassword")}
+						/>
+					</div>
+					{form.formState.errors.root ? (
+						<p className="text-sm text-destructive">
+							{form.formState.errors.root.message}
+						</p>
+					) : null}
+					<div className="flex items-center gap-3">
+						<Button type="submit" disabled={form.formState.isSubmitting}>
+							{form.formState.isSubmitting ? "Saving..." : "Change password"}
+						</Button>
+						{saved ? (
+							<p className="text-sm text-muted-foreground">Password changed.</p>
+						) : null}
+					</div>
+				</form>
+			</CardContent>
+		</Card>
+	);
+}
+`;
+const settingsAppearancePage = `import {
+	Card,
+	CardAction,
+	CardDescription,
+	CardHeader,
+	CardTitle,
+} from "@/components/ui/card";
+import { ThemeToggle } from "@/components/theme-toggle";
+export default function SettingsAppearancePage() {
+	return (
+		<Card>
+			<CardHeader>
+				<CardTitle>Appearance</CardTitle>
+				<CardDescription>
+					Choose light, dark, or follow your system preference. The choice is
+					saved on this device.
+				</CardDescription>
+				<CardAction>
+					<ThemeToggle />
+				</CardAction>
+			</CardHeader>
+		</Card>
+	);
+}
+`;
+const settingsAccountPage = `"use client";
+import { rootFormError } from "@beignet/react-hook-form";
+import { useRouter } from "next/navigation";
+import { useForm } from "react-hook-form";
+import { authClient } from "@/client/auth-client";
+import { Button } from "@/components/ui/button";
+import {
+	Card,
+	CardContent,
+	CardDescription,
+	CardHeader,
+	CardTitle,
+} from "@/components/ui/card";
+import { Input } from "@/components/ui/input";
+import { Label } from "@/components/ui/label";
+type DeleteAccountValues = {
+	password: string;
+};
+export default function SettingsAccountPage() {
+	const router = useRouter();
+	const form = useForm<DeleteAccountValues>({
+		defaultValues: { password: "" },
+	});
+	const onSubmit = form.handleSubmit(async (values) => {
+		form.clearErrors("root");
+		const result = await authClient.deleteUser({ password: values.password });
+		if (result.error) {
+			form.setError(
+				"root",
+				rootFormError(
+					result.error,
+					result.error.message || "Could not delete your account.",
+				),
+			);
+			return;
+		}
+		router.push("/");
+		router.refresh();
+	});
+	return (
+		<Card>
+			<CardHeader>
+				<CardTitle className="text-destructive">Delete account</CardTitle>
+				<CardDescription>
+					Permanently delete your account and all of its data. This cannot be
+					undone.
+				</CardDescription>
+			</CardHeader>
+			<CardContent>
+				<form className="flex max-w-sm flex-col gap-4" onSubmit={onSubmit}>
+					<div className="flex flex-col gap-2">
+						<Label htmlFor="password">Confirm your password</Label>
+						<Input
+							id="password"
+							type="password"
+							autoComplete="current-password"
+							required
+							{...form.register("password")}
+						/>
+					</div>
+					{form.formState.errors.root ? (
+						<p className="text-sm text-destructive">
+							{form.formState.errors.root.message}
+						</p>
+					) : null}
+					<Button
+						type="submit"
+						variant="destructive"
+						disabled={form.formState.isSubmitting}
+					>
+						{form.formState.isSubmitting ? "Deleting..." : "Delete account"}
+					</Button>
+				</form>
+			</CardContent>
+		</Card>
+	);
+}
+`;
+const clientIndex = `import { createClient } from "@beignet/core/client";
+import { createReactQuery } from "@beignet/react-query";
+import { QueryClient } from "@tanstack/react-query";
+export const apiClient = createClient({
+	validateInput: true,
+});
+export const rq = createReactQuery(apiClient);
+export function makeQueryClient() {
+	return new QueryClient({
+		defaultOptions: {
+			queries: {
+				staleTime: 60 * 1000,
+			},
+		},
+	});
+}
+`;
+const authClientFile = `import { createAuthClient } from "better-auth/react";
+export const authClient = createAuthClient();
+`;
+const formsClient = `import { createReactHookForm } from "@beignet/react-hook-form";
+export const rhf = createReactHookForm();
+`;
+const themeProvider = `"use client";
+import { ThemeProvider as NextThemesProvider } from "next-themes";
+import type { ComponentProps } from "react";
+export function ThemeProvider({
+	children,
+	...props
+}: ComponentProps<typeof NextThemesProvider>) {
+	return <NextThemesProvider {...props}>{children}</NextThemesProvider>;
+}
+`;
+const themeToggle = `"use client";
+import { MoonIcon, SunIcon } from "lucide-react";
+import { useTheme } from "next-themes";
+import { Button } from "@/components/ui/button";
+import {
+	DropdownMenu,
+	DropdownMenuContent,
+	DropdownMenuItem,
+	DropdownMenuTrigger,
+} from "@/components/ui/dropdown-menu";
+export function ThemeToggle() {
+	const { setTheme } = useTheme();
+	return (
+		<DropdownMenu>
+			<DropdownMenuTrigger asChild>
+				<Button type="button" variant="ghost" size="icon" aria-label="Change theme">
+					<SunIcon className="dark:hidden" />
+					<MoonIcon className="hidden dark:block" />
+				</Button>
+			</DropdownMenuTrigger>
+			<DropdownMenuContent align="end">
+				<DropdownMenuItem onClick={() => setTheme("light")}>
+					Light
+				</DropdownMenuItem>
+				<DropdownMenuItem onClick={() => setTheme("dark")}>
+					Dark
+				</DropdownMenuItem>
+				<DropdownMenuItem onClick={() => setTheme("system")}>
+					System
+				</DropdownMenuItem>
+			</DropdownMenuContent>
+		</DropdownMenu>
+	);
+}
+`;
+const appSidebar = `"use client";
+import {
+	FileJsonIcon,
+	LayoutDashboardIcon,
+	ListTodoIcon,
+	LogOutIcon,
+	SettingsIcon,
+	WrenchIcon,
+} from "lucide-react";
+import Link from "next/link";
+import { usePathname, useRouter } from "next/navigation";
+import { authClient } from "@/client/auth-client";
+import { Button } from "@/components/ui/button";
+import { Separator } from "@/components/ui/separator";
+import { cn } from "@/lib/utils";
+const navLinks = [
+	{ href: "/dashboard", label: "Dashboard", icon: LayoutDashboardIcon },
+	{ href: "/todos", label: "Todos", icon: ListTodoIcon },
+	{ href: "/settings", label: "Settings", icon: SettingsIcon },
+];
+const linkClassName =
+	"flex items-center gap-2 rounded-lg px-2 py-1.5 text-sm font-medium text-sidebar-foreground/70 hover:bg-sidebar-accent hover:text-sidebar-accent-foreground";
+export function AppSidebar({
+	user,
+	showDevtools,
+	showOpenapi,
+}: {
+	user: { name: string; email: string };
+	showDevtools: boolean;
+	showOpenapi: boolean;
+}) {
+	const pathname = usePathname();
+	const router = useRouter();
+	async function signOut() {
+		await authClient.signOut();
+		router.push("/");
+		router.refresh();
+	}
+	return (
+		<aside className="sticky top-0 flex h-svh w-60 shrink-0 flex-col border-r bg-sidebar text-sidebar-foreground">
+			<div className="px-5 py-4">
+				<Link href="/dashboard" className="font-heading text-sm font-semibold">
+					Beignet app
+				</Link>
+			</div>
+			<nav className="flex flex-1 flex-col gap-1 px-3" aria-label="Main">
+				{navLinks.map((link) => (
+					<Link
+						key={link.href}
+						href={link.href}
+						className={cn(
+							linkClassName,
+							(pathname === link.href ||
+								pathname.startsWith(\`\${link.href}/\`)) &&
+								"bg-sidebar-accent text-sidebar-accent-foreground",
+						)}
+					>
+						<link.icon className="size-4" />
+						{link.label}
+					</Link>
+				))}
+				{showDevtools || showOpenapi ? <Separator className="my-2" /> : null}
+				{showDevtools ? (
+					<a href="/api/devtools" className={linkClassName}>
+						<WrenchIcon className="size-4" />
+						Devtools
+					</a>
+				) : null}
+				{showOpenapi ? (
+					<a href="/api/openapi" className={linkClassName}>
+						<FileJsonIcon className="size-4" />
+						OpenAPI
+					</a>
+				) : null}
+			</nav>
+			<div className="flex items-center gap-2 border-t p-3">
+				<div className="min-w-0 flex-1">
+					<p className="truncate text-sm font-medium">{user.name}</p>
+					<p className="truncate text-xs text-muted-foreground">{user.email}</p>
+				</div>
+				<Button
+					type="button"
+					variant="ghost"
+					size="icon"
+					aria-label="Sign out"
+					onClick={signOut}
+				>
+					<LogOutIcon />
+				</Button>
+			</div>
+		</aside>
+	);
+}
+`;
+const settingsNav = `"use client";
+import Link from "next/link";
+import { usePathname } from "next/navigation";
+import { cn } from "@/lib/utils";
+const settingsLinks = [
+	{ href: "/settings", label: "Profile" },
+	{ href: "/settings/password", label: "Password" },
+	{ href: "/settings/appearance", label: "Appearance" },
+	{ href: "/settings/account", label: "Account" },
+];
+export function SettingsNav() {
+	const pathname = usePathname();
+	return (
+		<nav className="flex flex-wrap gap-1" aria-label="Settings">
+			{settingsLinks.map((link) => (
+				<Link
+					key={link.href}
+					href={link.href}
+					className={cn(
+						"rounded-lg px-2.5 py-1.5 text-sm font-medium text-muted-foreground hover:bg-muted hover:text-foreground",
+						pathname === link.href && "bg-muted text-foreground",
+					)}
+				>
+					{link.label}
+				</Link>
+			))}
+		</nav>
+	);
+}
+`;
+const todoApp = `"use client";
+import { rootFormError } from "@beignet/react-hook-form";
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { Trash2Icon } from "lucide-react";
+import { rq } from "@/client";
+import { rhf } from "@/client/forms";
+import { Button } from "@/components/ui/button";
+import { Card, CardContent } from "@/components/ui/card";
+import { Checkbox } from "@/components/ui/checkbox";
+import { Input } from "@/components/ui/input";
+import { Label } from "@/components/ui/label";
+import {
+	createTodo,
+	deleteTodo,
+	listTodos,
+	updateTodo,
+} from "@/features/todos/contracts";
+import { cn } from "@/lib/utils";
+const createTodoForm = rhf(createTodo);
+export function TodoApp() {
+	const queryClient = useQueryClient();
+	const todosQuery = useQuery(rq(listTodos).queryOptions());
+	const form = createTodoForm.useForm({
+		defaultValues: { title: "" },
+	});
+	const invalidateTodos = () => rq(listTodos).invalidate(queryClient);
+	const createTodoMutation = useMutation(
+		rq(createTodo).mutationOptions({
+			onSuccess: async () => {
+				form.reset();
+				await invalidateTodos();
+			},
+			onError: (error) => {
+				form.setError("root", rootFormError(error, "Could not create the todo."));
+			},
+		}),
+	);
+	const updateTodoMutation = useMutation(
+		rq(updateTodo).mutationOptions({
+			onSuccess: invalidateTodos,
+		}),
+	);
+	const deleteTodoMutation = useMutation(
+		rq(deleteTodo).mutationOptions({
+			onSuccess: invalidateTodos,
+		}),
+	);
+	const onSubmit = form.handleSubmit((body) => {
+		form.clearErrors("root");
+		createTodoMutation.mutate({ body });
+	});
+	const todos = todosQuery.data?.items ?? [];
+	return (
+		<section className="flex flex-col gap-4">
+			<form className="flex flex-col gap-2" onSubmit={onSubmit}>
+				<Label htmlFor="todo-title">New todo</Label>
+				<div className="flex gap-2">
+					<Input
+						id="todo-title"
+						autoComplete="off"
+						placeholder="Ship something type-safe"
+						{...form.register("title")}
+					/>
+					<Button type="submit" disabled={createTodoMutation.isPending}>
+						{createTodoMutation.isPending ? "Adding..." : "Add"}
+					</Button>
+				</div>
+				{form.formState.errors.title ? (
+					<p className="text-sm text-destructive">
+						{form.formState.errors.title.message}
+					</p>
+				) : null}
+				{form.formState.errors.root ? (
+					<p className="text-sm text-destructive">
+						{form.formState.errors.root.message}
+					</p>
+				) : null}
+			</form>
+			<Card className="py-0">
+				<CardContent className="px-0">
+					{todosQuery.isPending ? (
+						<p className="px-4 py-6 text-sm text-muted-foreground">
+							Loading todos...
+						</p>
+					) : todosQuery.isError ? (
+						<p className="px-4 py-6 text-sm text-destructive">
+							Could not load todos.
+						</p>
+					) : todos.length === 0 ? (
+						<p className="px-4 py-6 text-sm text-muted-foreground">
+							Nothing here yet — add your first todo.
+						</p>
+					) : (
+						<ul className="divide-y">
+							{todos.map((todo) => (
+								<li key={todo.id} className="flex items-center gap-3 px-4 py-3">
+									<Checkbox
+										id={\`todo-\${todo.id}\`}
+										checked={todo.completed}
+										disabled={updateTodoMutation.isPending}
+										onCheckedChange={(checked) =>
+											updateTodoMutation.mutate({
+												path: { id: todo.id },
+												body: { completed: checked === true },
+											})
+										}
+									/>
+									<label
+										htmlFor={\`todo-\${todo.id}\`}
+										className={cn(
+											"flex-1 text-sm",
+											todo.completed && "text-muted-foreground line-through",
+										)}
+									>
+										{todo.title}
+									</label>
+									<Button
+										type="button"
+										variant="ghost"
+										size="icon-sm"
+										aria-label="Delete todo"
+										disabled={deleteTodoMutation.isPending}
+										onClick={() =>
+											deleteTodoMutation.mutate({ path: { id: todo.id } })
+										}
+									>
+										<Trash2Icon />
+									</Button>
+								</li>
+							))}
+						</ul>
+					)}
+				</CardContent>
+			</Card>
+		</section>
+	);
+}
+`;
+export function shellTemplateFiles(ctx: TemplateContext): TemplateFile[] {
+  return [
+    { path: "app/layout.tsx", content: rootLayout },
+    { path: "app/providers.tsx", content: appProviders },
+    { path: "app/page.tsx", content: landingPage },
+    { path: "app/(auth)/layout.tsx", content: authLayout },
+    { path: "app/(auth)/sign-in/page.tsx", content: signInPage },
+    { path: "app/(auth)/sign-up/page.tsx", content: signUpPage },
+    { path: "app/(app)/layout.tsx", content: appLayout },
+    { path: "app/(app)/dashboard/page.tsx", content: dashboardPage(ctx) },
+    { path: "app/(app)/todos/page.tsx", content: todosPage },
+    { path: "app/(app)/settings/layout.tsx", content: settingsLayout },
+    { path: "app/(app)/settings/page.tsx", content: settingsProfilePage },
+    {
+      path: "app/(app)/settings/password/page.tsx",
+      content: settingsPasswordPage,
+    },
+    {
+      path: "app/(app)/settings/appearance/page.tsx",
+      content: settingsAppearancePage,
+    },
+    {
+      path: "app/(app)/settings/account/page.tsx",
+      content: settingsAccountPage,
+    },
+    { path: "client/index.ts", content: clientIndex },
+    { path: "client/auth-client.ts", content: authClientFile },
+    { path: "client/forms.ts", content: formsClient },
+    { path: "components/theme-provider.tsx", content: themeProvider },
+    { path: "components/theme-toggle.tsx", content: themeToggle },
+    { path: "components/app-sidebar.tsx", content: appSidebar },
+    { path: "components/settings-nav.tsx", content: settingsNav },
+    {
+      path: "features/todos/components/todo-app.tsx",
+      content: todoApp,
+    },
+  ];
+}
+export const shellDependencies: Record<string, string> = {
+  "better-auth": "1.6.11",
+  "lucide-react": "^1.16.0",
+  "next-themes": "^0.4.6",
+};
+export const shellDevDependencies: Record<string, string> = {};