create-kuckit-app 0.4.1 → 1.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "create-kuckit-app",
-	"version": "0.4.1",
+	"version": "1.0.0",
 	"description": "Create a new Kuckit application",
 	"type": "module",
 	"license": "MIT",

package/templates/base/.claude/{commands/file-beads.md → skills/file-beads/SKILL.md}

@@ -1,6 +1,6 @@
 ---
-description: File detailed Beads epics and issues from a plan
-argument-hint: <plan-description-or-context>
+name: file-beads
+description: File detailed Beads epics and issues from a plan. Use when converting plans, roadmaps, or feature specs into structured Beads issues with proper dependencies.
 ---
 
 # File Beads Epics and Issues from Plan
@@ -9,7 +9,7 @@ You are tasked with converting a plan into a comprehensive set of Beads epics an
 
 ## Step 1: Understand the Plan
 
-First, review the plan context provided: `$ARGUMENTS`
+First, review the plan context provided by the user.
 
 If no specific plan is provided, ask the user to share the plan or point to a planning document (check `history/` directory for recent plans).
 

package/templates/base/.claude/{commands/review-beads.md → skills/review-beads/SKILL.md}

@@ -1,6 +1,6 @@
 ---
-description: Review, proofread, and refine filed Beads epics and issues
-argument-hint: [optional: specific epic or issue IDs to focus on]
+name: review-beads
+description: Review, proofread, and refine filed Beads epics and issues. Use when you need to polish issues for clarity, fix dependencies, or ensure workers have a smooth implementation experience.
 ---
 
 # Review and Refine Beads Issues
@@ -16,7 +16,7 @@ bd list --json
 bd ready --json
 ```
 
-If specific IDs were provided (`$ARGUMENTS`), focus on those. Otherwise, review all issues.
+If specific IDs were provided, focus on those. Otherwise, review all issues.
 
 ## Step 2: Systematic Review Checklist
 

package/templates/base/apps/server/package.json

@@ -5,7 +5,7 @@
 	"scripts": {
 		"build": "tsdown",
 		"check-types": "tsc -b",
-		"dev": "kuckit dev"
+		"dev": "bun run --hot src/server.ts"
 	},
 	"dependencies": {
 		"dotenv": "^17.0.0",

package/templates/base/apps/web/AGENTS.md

@@ -8,13 +8,12 @@ React frontend using TanStack Router, TanStack Query, and Kuckit client modules.
 
 ## Key Files
 
-| File                               | Purpose                           |
-| ---------------------------------- | --------------------------------- |
-| `main.tsx`                         | App entry point (17 lines)        |
-| `modules.client.ts`                | Client module registration        |
-| `routes/`                          | TanStack Router file-based routes |
-| `routes/$.tsx`                     | Catch-all for module routes       |
-| `components/KuckitModuleRoute.tsx` | Renders module-registered routes  |
+| File                | Purpose                                            |
+| ------------------- | -------------------------------------------------- |
+| `main.tsx`          | App entry point (17 lines)                         |
+| `modules.client.ts` | Client module registration                         |
+| `routes/`           | TanStack Router file-based routes                  |
+| `routes/$.tsx`      | Catch-all for module routes (uses @kuckit/app-web) |
 
 ## How It Works
 

package/templates/base/apps/web/src/routes/$.tsx

@@ -1,5 +1,5 @@
 import { createFileRoute } from '@tanstack/react-router'
-import { KuckitModuleRoute } from '@/components/KuckitModuleRoute'
+import { KuckitModuleRoute } from '@kuckit/app-web'
 
 /**
  * Catch-all route for KuckitModule routes at root level.

package/templates/base/apps/web/src/routes/dashboard/$.tsx

@@ -1,5 +1,5 @@
 import { createFileRoute } from '@tanstack/react-router'
-import { KuckitModuleRoute } from '@/components/KuckitModuleRoute'
+import { KuckitModuleRoute } from '@kuckit/app-web'
 
 /**
  * Catch-all route for KuckitModule routes under /dashboard.

package/templates/base/docker-compose.yml

@@ -11,7 +11,7 @@ services:
     ports:
       - '5432:5432'
     volumes:
-      - __APP_NAME_KEBAB___postgres_data:/var/lib/postgresql/data
+      - __APP_NAME_KEBAB___postgres_data:/var/lib/postgresql
     healthcheck:
       test: ['CMD-SHELL', 'pg_isready -U postgres']
       interval: 10s

package/templates/base/package.json

@@ -34,8 +34,11 @@
 		"@kuckit/api": "^2.0.0",
 		"@kuckit/auth": "^2.0.0",
 		"@kuckit/db": "^2.0.0",
+		"@kuckit/domain": "^2.0.0",
+		"@kuckit/infrastructure": "^2.0.0",
 		"awilix": "^12.0.5",
 		"dotenv": "^17.0.0",
+		"drizzle-orm": "^0.44.0",
 		"zod": "^3.23.0"
 	},
 	"devDependencies": {

package/templates/base/apps/web/src/components/KuckitModuleRoute.tsx

@@ -1,141 +0,0 @@
-import { useRouterState, Link, useNavigate } from '@tanstack/react-router'
-import { useKuckitWeb, useAuth } from '@kuckit/app-web'
-import { useEffect, useState } from 'react'
-
-/**
- * Helper to determine if a route path is a root-level route (outside dashboard).
- * Root routes start with '/' but NOT '/dashboard'.
- */
-function isRootLevelRoute(path: string): boolean {
-	return path.startsWith('/') && !path.startsWith('/dashboard')
-}
-
-/**
- * Dynamic route renderer for Kuckit module routes.
- *
- * This component looks up the current path in the RouteRegistry
- * and renders the corresponding module component if found.
- *
- * Route resolution is context-aware:
- * - When rendered under /dashboard/*: matches dashboard routes
- * - When rendered at root level: matches root-level routes (paths starting with '/' but not '/dashboard/')
- *
- * For root routes with meta.requiresAuth: true, redirects to /login if not authenticated.
- */
-export function KuckitModuleRoute() {
-	const { routeRegistry } = useKuckitWeb()
-	const authClient = useAuth()
-	const { location } = useRouterState()
-	const navigate = useNavigate()
-	const pathname = location.pathname
-
-	const [authChecked, setAuthChecked] = useState(false)
-	const [isAuthenticated, setIsAuthenticated] = useState(false)
-
-	// Determine if we're in dashboard context
-	const isDashboardContext = pathname.startsWith('/dashboard')
-
-	// Filter routes based on context
-	const contextRoutes = routeRegistry.getAll().filter((r) => {
-		const isRoot = isRootLevelRoute(r.path)
-		// In dashboard context: show non-root routes
-		// In root context: show root routes
-		return isDashboardContext ? !isRoot : isRoot
-	})
-
-	// For dashboard context, also try matching with /dashboard prefix stripped
-	const modulePathname = isDashboardContext ? pathname.replace('/dashboard', '') || '/' : pathname
-
-	// Match route path against pathname, supporting catch-all patterns like /docs/$
-	function matchRoute(routePath: string, pathname: string): boolean {
-		// Exact match
-		if (routePath === pathname) return true
-
-		// Catch-all pattern: /docs/$ matches /docs/anything/here
-		if (routePath.endsWith('/$')) {
-			const base = routePath.slice(0, -1) // Remove trailing $
-			return pathname.startsWith(base)
-		}
-
-		return false
-	}
-
-	// Find matching route - prefer exact matches over catch-all
-	const exactMatch = contextRoutes.find((r) => r.path === pathname)
-	const catchAllMatch = contextRoutes.find(
-		(r) => r.path.endsWith('/$') && matchRoute(r.path, pathname)
-	)
-	let routeDef = exactMatch || catchAllMatch
-
-	if (!routeDef && isDashboardContext) {
-		// For dashboard routes, also try matching stripped path
-		const exactDash = contextRoutes.find((r) => r.path === modulePathname)
-		const catchAllDash = contextRoutes.find(
-			(r) => r.path.endsWith('/$') && matchRoute(r.path, modulePathname)
-		)
-		routeDef = exactDash || catchAllDash
-	}
-
-	// Check auth for root routes with requiresAuth
-	useEffect(() => {
-		async function checkAuth() {
-			if (!routeDef) {
-				setAuthChecked(true)
-				return
-			}
-
-			// Dashboard routes are already protected by the dashboard layout
-			if (isDashboardContext) {
-				setAuthChecked(true)
-				setIsAuthenticated(true)
-				return
-			}
-
-			// For root routes, check if auth is required
-			if (routeDef.meta?.requiresAuth) {
-				const session = await authClient.getSession()
-				if (!session.data) {
-					// Redirect to login with return URL
-					navigate({
-						to: '/login',
-						search: { redirect: pathname },
-					})
-					return
-				}
-				setIsAuthenticated(true)
-			}
-			setAuthChecked(true)
-		}
-
-		checkAuth()
-	}, [routeDef, isDashboardContext, pathname, navigate, authClient])
-
-	// Show loading while checking auth for protected root routes
-	if (!isDashboardContext && routeDef?.meta?.requiresAuth && !authChecked) {
-		return (
-			<div className="flex items-center justify-center min-h-screen">
-				<div className="animate-spin rounded-full h-8 w-8 border-b-2 border-primary" />
-			</div>
-		)
-	}
-
-	// Protected root route - waiting for redirect
-	if (!isDashboardContext && routeDef?.meta?.requiresAuth && !isAuthenticated) {
-		return null
-	}
-
-	if (!routeDef) {
-		return (
-			<div className="flex flex-col items-center justify-center min-h-[50vh] gap-4">
-				<h1 className="text-2xl font-bold">Page Not Found</h1>
-				<p className="text-muted-foreground">The page "{pathname}" could not be found.</p>
-				<Link to="/" className="text-primary hover:underline">
-					Go Home
-				</Link>
-			</div>
-		)
-	}
-
-	const Component = routeDef.component as React.ComponentType
-	return <Component />
-}