create-croissant 0.1.14 → 0.1.16

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.1.14",
+  "version": "0.1.16",
   "description": "Scaffold a new project using the Croissant Stack",
   "repository": {
     "type": "git",

package/template/apps/web/src/components/app-sidebar.tsx

@@ -26,23 +26,23 @@ const data = {
       items: [
         {
           title: "SSR + oRPC",
-          url: "/ssr-orpc",
+          url: "/examples/ssr-orpc",
         },
         {
           title: "SSR + oRPC (Auth)",
-          url: "/ssr-orpc-auth",
+          url: "/examples/ssr-orpc-auth",
         },
         {
           title: "Client + oRPC",
-          url: "/client-orpc",
+          url: "/examples/client-orpc",
         },
         {
           title: "Client + oRPC (Auth)",
-          url: "/client-orpc-auth",
+          url: "/examples/client-orpc-auth",
         },
         {
           title: "ISR",
-          url: "/isr",
+          url: "/examples/isr",
         },
       ],
     },

package/template/apps/web/src/routeTree.gen.ts

@@ -9,29 +9,19 @@
 // Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified.
 
 import { Route as rootRouteImport } from './routes/__root'
-import { Route as SsrOrpcAuthRouteImport } from './routes/ssr-orpc-auth'
-import { Route as SsrOrpcRouteImport } from './routes/ssr-orpc'
 import { Route as SignupRouteImport } from './routes/signup'
 import { Route as LoginRouteImport } from './routes/login'
-import { Route as IsrRouteImport } from './routes/isr'
 import { Route as DashboardRouteImport } from './routes/dashboard'
-import { Route as ClientOrpcAuthRouteImport } from './routes/client-orpc-auth'
-import { Route as ClientOrpcRouteImport } from './routes/client-orpc'
 import { Route as AccountRouteImport } from './routes/account'
 import { Route as IndexRouteImport } from './routes/index'
+import { Route as ExamplesSsrOrpcAuthRouteImport } from './routes/examples/ssr-orpc-auth'
+import { Route as ExamplesSsrOrpcRouteImport } from './routes/examples/ssr-orpc'
+import { Route as ExamplesIsrRouteImport } from './routes/examples/isr'
+import { Route as ExamplesClientOrpcAuthRouteImport } from './routes/examples/client-orpc-auth'
+import { Route as ExamplesClientOrpcRouteImport } from './routes/examples/client-orpc'
 import { Route as ApiRpcSplatRouteImport } from './routes/api/rpc.$'
 import { Route as ApiAuthSplatRouteImport } from './routes/api/auth/$'
 
-const SsrOrpcAuthRoute = SsrOrpcAuthRouteImport.update({
-  id: '/ssr-orpc-auth',
-  path: '/ssr-orpc-auth',
-  getParentRoute: () => rootRouteImport,
-} as any)
-const SsrOrpcRoute = SsrOrpcRouteImport.update({
-  id: '/ssr-orpc',
-  path: '/ssr-orpc',
-  getParentRoute: () => rootRouteImport,
-} as any)
 const SignupRoute = SignupRouteImport.update({
   id: '/signup',
   path: '/signup',
@@ -42,26 +32,11 @@ const LoginRoute = LoginRouteImport.update({
   path: '/login',
   getParentRoute: () => rootRouteImport,
 } as any)
-const IsrRoute = IsrRouteImport.update({
-  id: '/isr',
-  path: '/isr',
-  getParentRoute: () => rootRouteImport,
-} as any)
 const DashboardRoute = DashboardRouteImport.update({
   id: '/dashboard',
   path: '/dashboard',
   getParentRoute: () => rootRouteImport,
 } as any)
-const ClientOrpcAuthRoute = ClientOrpcAuthRouteImport.update({
-  id: '/client-orpc-auth',
-  path: '/client-orpc-auth',
-  getParentRoute: () => rootRouteImport,
-} as any)
-const ClientOrpcRoute = ClientOrpcRouteImport.update({
-  id: '/client-orpc',
-  path: '/client-orpc',
-  getParentRoute: () => rootRouteImport,
-} as any)
 const AccountRoute = AccountRouteImport.update({
   id: '/account',
   path: '/account',
@@ -72,6 +47,31 @@ const IndexRoute = IndexRouteImport.update({
   path: '/',
   getParentRoute: () => rootRouteImport,
 } as any)
+const ExamplesSsrOrpcAuthRoute = ExamplesSsrOrpcAuthRouteImport.update({
+  id: '/examples/ssr-orpc-auth',
+  path: '/examples/ssr-orpc-auth',
+  getParentRoute: () => rootRouteImport,
+} as any)
+const ExamplesSsrOrpcRoute = ExamplesSsrOrpcRouteImport.update({
+  id: '/examples/ssr-orpc',
+  path: '/examples/ssr-orpc',
+  getParentRoute: () => rootRouteImport,
+} as any)
+const ExamplesIsrRoute = ExamplesIsrRouteImport.update({
+  id: '/examples/isr',
+  path: '/examples/isr',
+  getParentRoute: () => rootRouteImport,
+} as any)
+const ExamplesClientOrpcAuthRoute = ExamplesClientOrpcAuthRouteImport.update({
+  id: '/examples/client-orpc-auth',
+  path: '/examples/client-orpc-auth',
+  getParentRoute: () => rootRouteImport,
+} as any)
+const ExamplesClientOrpcRoute = ExamplesClientOrpcRouteImport.update({
+  id: '/examples/client-orpc',
+  path: '/examples/client-orpc',
+  getParentRoute: () => rootRouteImport,
+} as any)
 const ApiRpcSplatRoute = ApiRpcSplatRouteImport.update({
   id: '/api/rpc/$',
   path: '/api/rpc/$',
@@ -86,28 +86,28 @@ const ApiAuthSplatRoute = ApiAuthSplatRouteImport.update({
 export interface FileRoutesByFullPath {
   '/': typeof IndexRoute
   '/account': typeof AccountRoute
-  '/client-orpc': typeof ClientOrpcRoute
-  '/client-orpc-auth': typeof ClientOrpcAuthRoute
   '/dashboard': typeof DashboardRoute
-  '/isr': typeof IsrRoute
   '/login': typeof LoginRoute
   '/signup': typeof SignupRoute
-  '/ssr-orpc': typeof SsrOrpcRoute
-  '/ssr-orpc-auth': typeof SsrOrpcAuthRoute
+  '/examples/client-orpc': typeof ExamplesClientOrpcRoute
+  '/examples/client-orpc-auth': typeof ExamplesClientOrpcAuthRoute
+  '/examples/isr': typeof ExamplesIsrRoute
+  '/examples/ssr-orpc': typeof ExamplesSsrOrpcRoute
+  '/examples/ssr-orpc-auth': typeof ExamplesSsrOrpcAuthRoute
   '/api/auth/$': typeof ApiAuthSplatRoute
   '/api/rpc/$': typeof ApiRpcSplatRoute
 }
 export interface FileRoutesByTo {
   '/': typeof IndexRoute
   '/account': typeof AccountRoute
-  '/client-orpc': typeof ClientOrpcRoute
-  '/client-orpc-auth': typeof ClientOrpcAuthRoute
   '/dashboard': typeof DashboardRoute
-  '/isr': typeof IsrRoute
   '/login': typeof LoginRoute
   '/signup': typeof SignupRoute
-  '/ssr-orpc': typeof SsrOrpcRoute
-  '/ssr-orpc-auth': typeof SsrOrpcAuthRoute
+  '/examples/client-orpc': typeof ExamplesClientOrpcRoute
+  '/examples/client-orpc-auth': typeof ExamplesClientOrpcAuthRoute
+  '/examples/isr': typeof ExamplesIsrRoute
+  '/examples/ssr-orpc': typeof ExamplesSsrOrpcRoute
+  '/examples/ssr-orpc-auth': typeof ExamplesSsrOrpcAuthRoute
   '/api/auth/$': typeof ApiAuthSplatRoute
   '/api/rpc/$': typeof ApiRpcSplatRoute
 }
@@ -115,14 +115,14 @@ export interface FileRoutesById {
   __root__: typeof rootRouteImport
   '/': typeof IndexRoute
   '/account': typeof AccountRoute
-  '/client-orpc': typeof ClientOrpcRoute
-  '/client-orpc-auth': typeof ClientOrpcAuthRoute
   '/dashboard': typeof DashboardRoute
-  '/isr': typeof IsrRoute
   '/login': typeof LoginRoute
   '/signup': typeof SignupRoute
-  '/ssr-orpc': typeof SsrOrpcRoute
-  '/ssr-orpc-auth': typeof SsrOrpcAuthRoute
+  '/examples/client-orpc': typeof ExamplesClientOrpcRoute
+  '/examples/client-orpc-auth': typeof ExamplesClientOrpcAuthRoute
+  '/examples/isr': typeof ExamplesIsrRoute
+  '/examples/ssr-orpc': typeof ExamplesSsrOrpcRoute
+  '/examples/ssr-orpc-auth': typeof ExamplesSsrOrpcAuthRoute
   '/api/auth/$': typeof ApiAuthSplatRoute
   '/api/rpc/$': typeof ApiRpcSplatRoute
 }
@@ -131,42 +131,42 @@ export interface FileRouteTypes {
   fullPaths:
     | '/'
     | '/account'
-    | '/client-orpc'
-    | '/client-orpc-auth'
     | '/dashboard'
-    | '/isr'
     | '/login'
     | '/signup'
-    | '/ssr-orpc'
-    | '/ssr-orpc-auth'
+    | '/examples/client-orpc'
+    | '/examples/client-orpc-auth'
+    | '/examples/isr'
+    | '/examples/ssr-orpc'
+    | '/examples/ssr-orpc-auth'
     | '/api/auth/$'
     | '/api/rpc/$'
   fileRoutesByTo: FileRoutesByTo
   to:
     | '/'
     | '/account'
-    | '/client-orpc'
-    | '/client-orpc-auth'
     | '/dashboard'
-    | '/isr'
     | '/login'
     | '/signup'
-    | '/ssr-orpc'
-    | '/ssr-orpc-auth'
+    | '/examples/client-orpc'
+    | '/examples/client-orpc-auth'
+    | '/examples/isr'
+    | '/examples/ssr-orpc'
+    | '/examples/ssr-orpc-auth'
     | '/api/auth/$'
     | '/api/rpc/$'
   id:
     | '__root__'
     | '/'
     | '/account'
-    | '/client-orpc'
-    | '/client-orpc-auth'
     | '/dashboard'
-    | '/isr'
     | '/login'
     | '/signup'
-    | '/ssr-orpc'
-    | '/ssr-orpc-auth'
+    | '/examples/client-orpc'
+    | '/examples/client-orpc-auth'
+    | '/examples/isr'
+    | '/examples/ssr-orpc'
+    | '/examples/ssr-orpc-auth'
     | '/api/auth/$'
     | '/api/rpc/$'
   fileRoutesById: FileRoutesById
@@ -174,34 +174,20 @@ export interface FileRouteTypes {
 export interface RootRouteChildren {
   IndexRoute: typeof IndexRoute
   AccountRoute: typeof AccountRoute
-  ClientOrpcRoute: typeof ClientOrpcRoute
-  ClientOrpcAuthRoute: typeof ClientOrpcAuthRoute
   DashboardRoute: typeof DashboardRoute
-  IsrRoute: typeof IsrRoute
   LoginRoute: typeof LoginRoute
   SignupRoute: typeof SignupRoute
-  SsrOrpcRoute: typeof SsrOrpcRoute
-  SsrOrpcAuthRoute: typeof SsrOrpcAuthRoute
+  ExamplesClientOrpcRoute: typeof ExamplesClientOrpcRoute
+  ExamplesClientOrpcAuthRoute: typeof ExamplesClientOrpcAuthRoute
+  ExamplesIsrRoute: typeof ExamplesIsrRoute
+  ExamplesSsrOrpcRoute: typeof ExamplesSsrOrpcRoute
+  ExamplesSsrOrpcAuthRoute: typeof ExamplesSsrOrpcAuthRoute
   ApiAuthSplatRoute: typeof ApiAuthSplatRoute
   ApiRpcSplatRoute: typeof ApiRpcSplatRoute
 }
 
 declare module '@tanstack/react-router' {
   interface FileRoutesByPath {
-    '/ssr-orpc-auth': {
-      id: '/ssr-orpc-auth'
-      path: '/ssr-orpc-auth'
-      fullPath: '/ssr-orpc-auth'
-      preLoaderRoute: typeof SsrOrpcAuthRouteImport
-      parentRoute: typeof rootRouteImport
-    }
-    '/ssr-orpc': {
-      id: '/ssr-orpc'
-      path: '/ssr-orpc'
-      fullPath: '/ssr-orpc'
-      preLoaderRoute: typeof SsrOrpcRouteImport
-      parentRoute: typeof rootRouteImport
-    }
     '/signup': {
       id: '/signup'
       path: '/signup'
@@ -216,13 +202,6 @@ declare module '@tanstack/react-router' {
       preLoaderRoute: typeof LoginRouteImport
       parentRoute: typeof rootRouteImport
     }
-    '/isr': {
-      id: '/isr'
-      path: '/isr'
-      fullPath: '/isr'
-      preLoaderRoute: typeof IsrRouteImport
-      parentRoute: typeof rootRouteImport
-    }
     '/dashboard': {
       id: '/dashboard'
       path: '/dashboard'
@@ -230,20 +209,6 @@ declare module '@tanstack/react-router' {
       preLoaderRoute: typeof DashboardRouteImport
       parentRoute: typeof rootRouteImport
     }
-    '/client-orpc-auth': {
-      id: '/client-orpc-auth'
-      path: '/client-orpc-auth'
-      fullPath: '/client-orpc-auth'
-      preLoaderRoute: typeof ClientOrpcAuthRouteImport
-      parentRoute: typeof rootRouteImport
-    }
-    '/client-orpc': {
-      id: '/client-orpc'
-      path: '/client-orpc'
-      fullPath: '/client-orpc'
-      preLoaderRoute: typeof ClientOrpcRouteImport
-      parentRoute: typeof rootRouteImport
-    }
     '/account': {
       id: '/account'
       path: '/account'
@@ -258,6 +223,41 @@ declare module '@tanstack/react-router' {
       preLoaderRoute: typeof IndexRouteImport
       parentRoute: typeof rootRouteImport
     }
+    '/examples/ssr-orpc-auth': {
+      id: '/examples/ssr-orpc-auth'
+      path: '/examples/ssr-orpc-auth'
+      fullPath: '/examples/ssr-orpc-auth'
+      preLoaderRoute: typeof ExamplesSsrOrpcAuthRouteImport
+      parentRoute: typeof rootRouteImport
+    }
+    '/examples/ssr-orpc': {
+      id: '/examples/ssr-orpc'
+      path: '/examples/ssr-orpc'
+      fullPath: '/examples/ssr-orpc'
+      preLoaderRoute: typeof ExamplesSsrOrpcRouteImport
+      parentRoute: typeof rootRouteImport
+    }
+    '/examples/isr': {
+      id: '/examples/isr'
+      path: '/examples/isr'
+      fullPath: '/examples/isr'
+      preLoaderRoute: typeof ExamplesIsrRouteImport
+      parentRoute: typeof rootRouteImport
+    }
+    '/examples/client-orpc-auth': {
+      id: '/examples/client-orpc-auth'
+      path: '/examples/client-orpc-auth'
+      fullPath: '/examples/client-orpc-auth'
+      preLoaderRoute: typeof ExamplesClientOrpcAuthRouteImport
+      parentRoute: typeof rootRouteImport
+    }
+    '/examples/client-orpc': {
+      id: '/examples/client-orpc'
+      path: '/examples/client-orpc'
+      fullPath: '/examples/client-orpc'
+      preLoaderRoute: typeof ExamplesClientOrpcRouteImport
+      parentRoute: typeof rootRouteImport
+    }
     '/api/rpc/$': {
       id: '/api/rpc/$'
       path: '/api/rpc/$'
@@ -278,14 +278,14 @@ declare module '@tanstack/react-router' {
 const rootRouteChildren: RootRouteChildren = {
   IndexRoute: IndexRoute,
   AccountRoute: AccountRoute,
-  ClientOrpcRoute: ClientOrpcRoute,
-  ClientOrpcAuthRoute: ClientOrpcAuthRoute,
   DashboardRoute: DashboardRoute,
-  IsrRoute: IsrRoute,
   LoginRoute: LoginRoute,
   SignupRoute: SignupRoute,
-  SsrOrpcRoute: SsrOrpcRoute,
-  SsrOrpcAuthRoute: SsrOrpcAuthRoute,
+  ExamplesClientOrpcRoute: ExamplesClientOrpcRoute,
+  ExamplesClientOrpcAuthRoute: ExamplesClientOrpcAuthRoute,
+  ExamplesIsrRoute: ExamplesIsrRoute,
+  ExamplesSsrOrpcRoute: ExamplesSsrOrpcRoute,
+  ExamplesSsrOrpcAuthRoute: ExamplesSsrOrpcAuthRoute,
   ApiAuthSplatRoute: ApiAuthSplatRoute,
   ApiRpcSplatRoute: ApiRpcSplatRoute,
 }

package/template/apps/web/src/routes/{client-orpc-auth.tsx → examples/client-orpc-auth.tsx}

@@ -3,14 +3,14 @@ import { useQuery } from "@tanstack/react-query"
 import { getSessionFn } from "@/lib/auth-utils"
 import { orpc } from "@/lib/orpc"
 
-export const Route = createFileRoute("/client-orpc-auth")({
+export const Route = createFileRoute("/examples/client-orpc-auth")({
   beforeLoad: async () => {
     const session = await getSessionFn()
     if (!session) {
       throw redirect({
         to: "/login",
         search: {
-          redirect: "/client-orpc-auth",
+          redirect: "/examples/client-orpc-auth",
         },
       })
     }

package/template/apps/web/src/routes/{client-orpc.tsx → examples/client-orpc.tsx}

@@ -29,7 +29,7 @@ const planetSchema = z.object({
   diameter: z.string().refine((val) => !isNaN(parseFloat(val)), "Must be a number"),
 })
 
-export const Route = createFileRoute("/client-orpc")({
+export const Route = createFileRoute("/examples/client-orpc")({
   component: ClientORPC,
 })
 

package/template/apps/web/src/routes/{isr.tsx → examples/isr.tsx}

@@ -1,7 +1,7 @@
 import { createFileRoute } from "@tanstack/react-router"
 import { orpc } from "@/lib/orpc"
 
-export const Route = createFileRoute("/isr")({
+export const Route = createFileRoute("/examples/isr")({
   loader: async () => {
     // In a real ISR scenario, this would be cached on the server
     // For this example, we'll fetch planets via oRPC

package/template/apps/web/src/routes/{ssr-orpc-auth.tsx → examples/ssr-orpc-auth.tsx}

@@ -2,14 +2,14 @@ import { createFileRoute, redirect } from "@tanstack/react-router"
 import { getSessionFn } from "@/lib/auth-utils"
 import { orpc } from "@/lib/orpc"
 
-export const Route = createFileRoute("/ssr-orpc-auth")({
+export const Route = createFileRoute("/examples/ssr-orpc-auth")({
   beforeLoad: async () => {
     const session = await getSessionFn()
     if (!session) {
       throw redirect({
         to: "/login",
         search: {
-          redirect: "/ssr-orpc-auth",
+          redirect: "/examples/ssr-orpc-auth",
         },
       })
     }

package/template/apps/web/src/routes/{ssr-orpc.tsx → examples/ssr-orpc.tsx}

@@ -27,7 +27,7 @@ const planetSchema = z.object({
   diameter: z.string().refine((val) => !isNaN(parseFloat(val)), "Must be a number"),
 })
 
-export const Route = createFileRoute("/ssr-orpc")({
+export const Route = createFileRoute("/examples/ssr-orpc")({
   loader: async () => {
     const planets = await orpc.planets.getPlanets()
     return { planets }

package/template/apps/web/vite.config.ts

@@ -10,7 +10,7 @@ const config = defineConfig({
     tailwindcss(),
     tanstackStart({
       prerender: {
-        filter: ({ path }) => path === "/isr",
+        filter: ({ path }) => path === "/examples/isr",
       },
     }),
     viteReact(),

package/template/SKILL.md

@@ -1,56 +0,0 @@
----
-name: croissant-stack
-description: Expert guidance for working with the Croissant Stack (TanStack Start, Better Auth, oRPC, Drizzle)
----
-
-# Croissant Stack
-
-This skill provides specialized knowledge and instructions for working within the Croissant Stack repository—a modern, type-safe full-stack monorepo.
-
-## When to use
-
-Use this skill when performing any task within this repository, including:
-- Developing features in the TanStack Start application (`apps/web`).
-- Managing the database schema or migrations (`packages/db`).
-- Extending the oRPC API (`packages/orpc`).
-- Configuring authentication with Better Auth (`packages/auth`).
-- Creating or modifying shared UI components (`packages/ui`).
-- Using or maintaining the `create-croissant` CLI.
-
-## Instructions
-
-### 1. Project Architecture
-Understand the monorepo structure powered by **Turborepo**:
-- **`apps/web`**: The main TanStack Start application.
-- **`packages/auth`**: Authentication logic using Better Auth.
-- **`packages/db`**: Database schema and Drizzle client.
-- **`packages/orpc`**: Modular, type-safe API layer.
-- **`packages/ui`**: Shared UI components using shadcn/ui.
-
-### 2. Local Development
-- **Install dependencies**: Use `npm install`.
-- **Database setup**: Run `npm run db:up` to start the PostgreSQL container.
-- **Environment variables**: Ensure `.env` exists at the root (copy from `.env.example`).
-- **Push schema**: Run `npm run db:push --filter @workspace/db` after schema changes.
-- **Start dev server**: Run `npm run dev` from the root. The app runs at `http://localhost:3000`.
-
-### 3. Working with oRPC
-- API procedures are located in `packages/orpc/src/lib/`.
-- The main router is in `packages/orpc/src/lib/router.ts`.
-- When adding new procedures, follow the modular pattern (e.g., create a new file in `lib/` and import it into the main router).
-
-### 4. Database & Schema
-- Define schemas in `packages/db/src/schema.ts` or modular files in `packages/db/src/`.
-- Use Drizzle Kit commands via Turbo: `npm run db:push --filter @workspace/db` or `npm run db:studio --filter @workspace/db`.
-
-### 5. UI Components
-- Shared components live in `packages/ui/src/components`.
-- Use the shadcn CLI to add new components: `npx shadcn@latest add [component-name] -c apps/web`. This is configured to place components into the shared package.
-
-### 6. Turborepo Commands
-- Use `--filter` to target specific packages: `npm run [command] --filter [package-name]`.
-- Example: `npm run build --filter web` or `npm run lint --filter @workspace/db`.
-
-### 7. Creating New Projects
-- The `packages/create-croissant` directory contains the source for the CLI tool.
-- The `template/` directory inside it should be kept in sync with the main repository structure.