@totaland/create-starter-kit 1.0.0 → 2.0.1

package/templates/frontend/postcss.config.js

@@ -0,0 +1,6 @@
+export default {
+    plugins: {
+        '@tailwindcss/postcss': {},
+        autoprefixer: {},
+    },
+};

package/templates/frontend/public/vite.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="31.88" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 257"><defs><linearGradient id="IconifyId1813088fe1fbc01fb466" x1="-.828%" x2="57.636%" y1="7.652%" y2="78.411%"><stop offset="0%" stop-color="#41D1FF"></stop><stop offset="100%" stop-color="#BD34FE"></stop></linearGradient><linearGradient id="IconifyId1813088fe1fbc01fb467" x1="43.376%" x2="50.316%" y1="2.242%" y2="89.03%"><stop offset="0%" stop-color="#FFEA83"></stop><stop offset="8.333%" stop-color="#FFDD35"></stop><stop offset="100%" stop-color="#FFA800"></stop></linearGradient></defs><path fill="url(#IconifyId1813088fe1fbc01fb466)" d="M255.153 37.938L134.897 252.976c-2.483 4.44-8.862 4.466-11.382.048L.875 37.958c-2.746-4.814 1.371-10.646 6.827-9.67l120.385 21.517a6.537 6.537 0 0 0 2.322-.004l117.867-21.483c5.438-.991 9.574 4.796 6.877 9.62Z"></path><path fill="url(#IconifyId1813088fe1fbc01fb467)" d="M185.432.063L96.44 17.501a3.268 3.268 0 0 0-2.634 3.014l-5.474 92.456a3.268 3.268 0 0 0 3.997 3.378l24.777-5.718c2.318-.535 4.413 1.507 3.936 3.838l-7.361 36.047c-.495 2.426 1.782 4.5 4.151 3.78l15.304-4.649c2.372-.72 4.652 1.36 4.15 3.788l-11.698 56.621c-.732 3.542 3.979 5.473 5.943 2.437l1.313-2.028l72.516-144.72c1.215-2.423-.88-5.186-3.54-4.672l-25.505 4.922c-2.396.462-4.435-1.77-3.759-4.114l16.646-57.705c.677-2.35-1.37-4.583-3.769-4.113Z"></path></svg>

package/templates/frontend/src/App.css

@@ -0,0 +1,42 @@
+#root {
+  max-width: 1280px;
+  margin: 0 auto;
+  padding: 2rem;
+  text-align: center;
+}
+
+.logo {
+  height: 6em;
+  padding: 1.5em;
+  will-change: filter;
+  transition: filter 300ms;
+}
+.logo:hover {
+  filter: drop-shadow(0 0 2em #646cffaa);
+}
+.logo.react:hover {
+  filter: drop-shadow(0 0 2em #61dafbaa);
+}
+
+@keyframes logo-spin {
+  from {
+    transform: rotate(0deg);
+  }
+  to {
+    transform: rotate(360deg);
+  }
+}
+
+@media (prefers-reduced-motion: no-preference) {
+  a:nth-of-type(2) .logo {
+    animation: logo-spin infinite 20s linear;
+  }
+}
+
+.card {
+  padding: 2em;
+}
+
+.read-the-docs {
+  color: #888;
+}

package/templates/frontend/src/App.tsx

@@ -0,0 +1,17 @@
+import { Route, Routes } from 'react-router-dom';
+import { Layout } from './components/layout/layout.component';
+import { AboutPage } from './pages/about/about.page';
+import { HomePage } from './pages/home/home.page';
+
+function App() {
+  return (
+    <Layout>
+      <Routes>
+        <Route path="/" element={<HomePage />} />
+        <Route path="/about" element={<AboutPage />} />
+      </Routes>
+    </Layout>
+  );
+}
+
+export default App;

package/templates/frontend/src/assets/react.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="35.93" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 228"><path fill="#00D8FF" d="M210.483 73.824a171.49 171.49 0 0 0-8.24-2.597c.465-1.9.893-3.777 1.273-5.621c6.238-30.281 2.16-54.676-11.769-62.708c-13.355-7.7-35.196.329-57.254 19.526a171.23 171.23 0 0 0-6.375 5.848a155.866 155.866 0 0 0-4.241-3.917C100.759 3.829 77.587-4.822 63.673 3.233C50.33 10.957 46.379 33.89 51.995 62.588a170.974 170.974 0 0 0 1.892 8.48c-3.28.932-6.445 1.924-9.474 2.98C17.309 83.498 0 98.307 0 113.668c0 15.865 18.582 31.778 46.812 41.427a145.52 145.52 0 0 0 6.921 2.165a167.467 167.467 0 0 0-2.01 9.138c-5.354 28.2-1.173 50.591 12.134 58.266c13.744 7.926 36.812-.22 59.273-19.855a145.567 145.567 0 0 0 5.342-4.923a168.064 168.064 0 0 0 6.92 6.314c21.758 18.722 43.246 26.282 56.54 18.586c13.731-7.949 18.194-32.003 12.4-61.268a145.016 145.016 0 0 0-1.535-6.842c1.62-.48 3.21-.974 4.76-1.488c29.348-9.723 48.443-25.443 48.443-41.52c0-15.417-17.868-30.326-45.517-39.844Zm-6.365 70.984c-1.4.463-2.836.91-4.3 1.345c-3.24-10.257-7.612-21.163-12.963-32.432c5.106-11 9.31-21.767 12.459-31.957c2.619.758 5.16 1.557 7.61 2.4c23.69 8.156 38.14 20.213 38.14 29.504c0 9.896-15.606 22.743-40.946 31.14Zm-10.514 20.834c2.562 12.94 2.927 24.64 1.23 33.787c-1.524 8.219-4.59 13.698-8.382 15.893c-8.067 4.67-25.32-1.4-43.927-17.412a156.726 156.726 0 0 1-6.437-5.87c7.214-7.889 14.423-17.06 21.459-27.246c12.376-1.098 24.068-2.894 34.671-5.345a134.17 134.17 0 0 1 1.386 6.193ZM87.276 214.515c-7.882 2.783-14.16 2.863-17.955.675c-8.075-4.657-11.432-22.636-6.853-46.752a156.923 156.923 0 0 1 1.869-8.499c10.486 2.32 22.093 3.988 34.498 4.994c7.084 9.967 14.501 19.128 21.976 27.15a134.668 134.668 0 0 1-4.877 4.492c-9.933 8.682-19.886 14.842-28.658 17.94ZM50.35 144.747c-12.483-4.267-22.792-9.812-29.858-15.863c-6.35-5.437-9.555-10.836-9.555-15.216c0-9.322 13.897-21.212 37.076-29.293c2.813-.98 5.757-1.905 8.812-2.773c3.204 10.42 7.406 21.315 12.477 32.332c-5.137 11.18-9.399 22.249-12.634 32.792a134.718 134.718 0 0 1-6.318-1.979Zm12.378-84.26c-4.811-24.587-1.616-43.134 6.425-47.789c8.564-4.958 27.502 2.111 47.463 19.835a144.318 144.318 0 0 1 3.841 3.545c-7.438 7.987-14.787 17.08-21.808 26.988c-12.04 1.116-23.565 2.908-34.161 5.309a160.342 160.342 0 0 1-1.76-7.887Zm110.427 27.268a347.8 347.8 0 0 0-7.785-12.803c8.168 1.033 15.994 2.404 23.343 4.08c-2.206 7.072-4.956 14.465-8.193 22.045a381.151 381.151 0 0 0-7.365-13.322Zm-45.032-43.861c5.044 5.465 10.096 11.566 15.065 18.186a322.04 322.04 0 0 0-30.257-.006c4.974-6.559 10.069-12.652 15.192-18.18ZM82.802 87.83a323.167 323.167 0 0 0-7.227 13.238c-3.184-7.553-5.909-14.98-8.134-22.152c7.304-1.634 15.093-2.97 23.209-3.984a321.524 321.524 0 0 0-7.848 12.897Zm8.081 65.352c-8.385-.936-16.291-2.203-23.593-3.793c2.26-7.3 5.045-14.885 8.298-22.6a321.187 321.187 0 0 0 7.257 13.246c2.594 4.48 5.28 8.868 8.038 13.147Zm37.542 31.03c-5.184-5.592-10.354-11.779-15.403-18.433c4.902.192 9.899.29 14.978.29c5.218 0 10.376-.117 15.453-.343c-4.985 6.774-10.018 12.97-15.028 18.486Zm52.198-57.817c3.422 7.8 6.306 15.345 8.596 22.52c-7.422 1.694-15.436 3.058-23.88 4.071a382.417 382.417 0 0 0 7.859-13.026a347.403 347.403 0 0 0 7.425-13.565Zm-16.898 8.101a358.557 358.557 0 0 1-12.281 19.815a329.4 329.4 0 0 1-23.444.823c-7.967 0-15.716-.248-23.178-.732a310.202 310.202 0 0 1-12.513-19.846h.001a307.41 307.41 0 0 1-10.923-20.627a310.278 310.278 0 0 1 10.89-20.637l-.001.001a307.318 307.318 0 0 1 12.413-19.761c7.613-.576 15.42-.876 23.31-.876H128c7.926 0 15.743.303 23.354.883a329.357 329.357 0 0 1 12.335 19.695a358.489 358.489 0 0 1 11.036 20.54a329.472 329.472 0 0 1-11 20.722Zm22.56-122.124c8.572 4.944 11.906 24.881 6.52 51.026c-.344 1.668-.73 3.367-1.15 5.09c-10.622-2.452-22.155-4.275-34.23-5.408c-7.034-10.017-14.323-19.124-21.64-27.008a160.789 160.789 0 0 1 5.888-5.4c18.9-16.447 36.564-22.941 44.612-18.3ZM128 90.808c12.625 0 22.86 10.235 22.86 22.86s-10.235 22.86-22.86 22.86s-22.86-10.235-22.86-22.86s10.235-22.86 22.86-22.86Z"></path></svg>

package/templates/frontend/src/components/layout/layout.component.tsx

@@ -0,0 +1,31 @@
+import type { ReactNode } from 'react';
+import { Link } from 'react-router-dom';
+
+interface LayoutProps {
+    children: ReactNode;
+}
+
+export function Layout({ children }: LayoutProps) {
+    return (
+        <div className="min-h-screen bg-background">
+            <header className="border-b">
+                <nav className="container mx-auto px-4 py-4">
+                    <div className="flex items-center justify-between">
+                        <Link to="/" className="text-xl font-bold">
+                            Starter Kit
+                        </Link>
+                        <div className="flex gap-4">
+                            <Link to="/" className="hover:text-primary">
+                                Home
+                            </Link>
+                            <Link to="/about" className="hover:text-primary">
+                                About
+                            </Link>
+                        </div>
+                    </div>
+                </nav>
+            </header>
+            <main className="container mx-auto px-4 py-8">{children}</main>
+        </div>
+    );
+}

package/templates/frontend/src/components/menu-toggle-icon.tsx

@@ -0,0 +1,53 @@
+import { cn } from "@/lib/utils";
+import type React from "react";
+
+type MenuToggleProps = React.ComponentProps<"svg"> & {
+	open: boolean;
+	duration?: number;
+};
+
+export function MenuToggleIcon({
+	open,
+	className,
+	fill = "none",
+	stroke = "currentColor",
+	strokeWidth = 2.5,
+	strokeLinecap = "round",
+	strokeLinejoin = "round",
+	duration = 500,
+	...props
+}: MenuToggleProps) {
+	return (
+		<svg
+			className={cn(
+				"transition-transform ease-in-out",
+				open && "-rotate-45",
+				className
+			)}
+			fill={fill}
+			stroke={stroke}
+			strokeLinecap={strokeLinecap}
+			strokeLinejoin={strokeLinejoin}
+			strokeWidth={strokeWidth}
+			style={{
+				transitionDuration: `${duration}ms`,
+			}}
+			viewBox="0 0 32 32"
+			{...props}
+		>
+			<path
+				className={cn(
+					"transition-all ease-in-out",
+					open
+						? "[stroke-dasharray:20_300] [stroke-dashoffset:-32.42px]"
+						: "[stroke-dasharray:12_63]"
+				)}
+				d="M27 10 13 10C10.8 10 9 8.2 9 6 9 3.5 10.8 2 13 2 15.2 2 17 3.8 17 6L17 26C17 28.2 18.8 30 21 30 23.2 30 25 28.2 25 26 25 23.8 23.2 22 21 22L7 22"
+				style={{
+					transitionDuration: `${duration}ms`,
+				}}
+			/>
+			<path d="M7 16 27 16" />
+		</svg>
+	);
+}

package/templates/frontend/src/components/ui/button.tsx

@@ -0,0 +1,57 @@
+import * as React from "react"
+import { Slot } from "@radix-ui/react-slot"
+import { cva, type VariantProps } from "class-variance-authority"
+
+import { cn } from "@/lib/utils"
+
+const buttonVariants = cva(
+  "inline-flex items-center justify-center gap-2 whitespace-nowrap rounded-md text-sm font-medium transition-colors focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg]:size-4 [&_svg]:shrink-0",
+  {
+    variants: {
+      variant: {
+        default:
+          "bg-primary text-primary-foreground shadow hover:bg-primary/90",
+        destructive:
+          "bg-destructive text-destructive-foreground shadow-sm hover:bg-destructive/90",
+        outline:
+          "border border-input bg-background shadow-sm hover:bg-accent hover:text-accent-foreground",
+        secondary:
+          "bg-secondary text-secondary-foreground shadow-sm hover:bg-secondary/80",
+        ghost: "hover:bg-accent hover:text-accent-foreground",
+        link: "text-primary underline-offset-4 hover:underline",
+      },
+      size: {
+        default: "h-9 px-4 py-2",
+        sm: "h-8 rounded-md px-3 text-xs",
+        lg: "h-10 rounded-md px-8",
+        icon: "h-9 w-9",
+      },
+    },
+    defaultVariants: {
+      variant: "default",
+      size: "default",
+    },
+  }
+)
+
+export interface ButtonProps
+  extends React.ButtonHTMLAttributes<HTMLButtonElement>,
+    VariantProps<typeof buttonVariants> {
+  asChild?: boolean
+}
+
+const Button = React.forwardRef<HTMLButtonElement, ButtonProps>(
+  ({ className, variant, size, asChild = false, ...props }, ref) => {
+    const Comp = asChild ? Slot : "button"
+    return (
+      <Comp
+        className={cn(buttonVariants({ variant, size, className }))}
+        ref={ref}
+        {...props}
+      />
+    )
+  }
+)
+Button.displayName = "Button"
+
+export { Button, buttonVariants }

package/templates/frontend/src/docs/RECOMMENDED_LIBRARIES.md

@@ -0,0 +1,226 @@
+# Additional UI Libraries & Tools to Consider
+
+This document lists recommended libraries and tools to enhance your frontend starter kit, organized by category.
+
+## UI Components & Styling
+
+### Already Included ✅
+- **shadcn/ui** - Copy-paste React components built with Radix UI and Tailwind
+- **Tailwind CSS** - Utility-first CSS framework
+- **Lucide React** - Beautiful, consistent icon library
+
+### Consider Adding
+
+#### Animation Libraries
+- **Framer Motion** - Production-ready motion library for React
+  ```bash
+  pnpm add framer-motion
+  ```
+
+#### Form Libraries
+- **React Hook Form** - Performant, flexible forms with easy validation
+  ```bash
+  pnpm add react-hook-form @hookform/resolvers
+  ```
+
+#### Date & Time
+- **date-fns** - Modern JavaScript date utility library
+  ```bash
+  pnpm add date-fns
+  ```
+- **react-day-picker** - Flexible date picker component
+  ```bash
+  pnpm add react-day-picker
+  ```
+
+#### Charts & Data Visualization
+- **Recharts** - Composable charting library built with React
+  ```bash
+  pnpm add recharts
+  ```
+- **Victory** - React charting library
+  ```bash
+  pnpm add victory
+  ```
+
+## State Management
+
+- **Zustand** - Small, fast state management (simpler alternative to Redux)
+  ```bash
+  pnpm add zustand
+  ```
+- **Jotai** - Primitive and flexible state management
+  ```bash
+  pnpm add jotai
+  ```
+
+## Utilities
+
+#### Validation (Already Included ✅)
+- **Zod** - TypeScript-first schema validation
+
+#### HTTP Client
+- **Axios** - Promise-based HTTP client (alternative to fetch)
+  ```bash
+  pnpm add axios
+  ```
+
+#### Formatting
+- **clsx** (Already included ✅) - Tiny utility for constructing className strings
+- **tailwind-merge** (Already included ✅) - Merge Tailwind CSS classes
+
+## Developer Experience
+
+### Already Included ✅
+- **Biome** - Fast linter and formatter
+- **TypeScript** - Static type checking
+- **Vite** - Lightning-fast build tool
+
+### Consider Adding
+
+#### Testing
+- **Vitest** - Vite-native unit testing framework
+  ```bash
+  pnpm add -D vitest @vitest/ui
+  ```
+- **Testing Library** - Simple testing utilities
+  ```bash
+  pnpm add -D @testing-library/react @testing-library/jest-dom @testing-library/user-event
+  ```
+- **Playwright** - End-to-end testing
+  ```bash
+  pnpm add -D @playwright/test
+  ```
+
+#### Documentation
+- **Storybook** - Component documentation and development
+  ```bash
+  pnpm dlx storybook@latest init
+  ```
+
+## Authentication & Security
+
+- **Auth.js (NextAuth.js)** - Authentication for React
+  ```bash
+  pnpm add next-auth
+  ```
+- **Clerk** - Complete authentication and user management
+  ```bash
+  pnpm add @clerk/clerk-react
+  ```
+
+## File Handling
+
+- **React Dropzone** - File upload with drag and drop
+  ```bash
+  pnpm add react-dropzone
+  ```
+
+## Tables & Data Grid
+
+- **TanStack Table** - Headless UI for building powerful tables
+  ```bash
+  pnpm add @tanstack/react-table
+  ```
+
+## Internationalization (i18n)
+
+- **react-i18next** - Internationalization framework
+  ```bash
+  pnpm add react-i18next i18next
+  ```
+
+## Accessibility
+
+- **@radix-ui/react-*** (Already included via shadcn/ui ✅) - Accessible component primitives
+- **react-aria** - Adobe's accessible UI primitives
+  ```bash
+  pnpm add react-aria
+  ```
+
+## Performance Monitoring
+
+- **@vercel/analytics** - Analytics for your app
+  ```bash
+  pnpm add @vercel/analytics
+  ```
+
+## Recommendations
+
+### Minimal Setup (Current)
+You currently have:
+- ✅ React Router (routing)
+- ✅ TanStack Query (data fetching)
+- ✅ shadcn/ui (components)
+- ✅ Tailwind CSS (styling)
+- ✅ Drizzle ORM (database)
+- ✅ Biome (linting/formatting)
+
+### Essential Additions
+Consider adding these for most projects:
+1. **React Hook Form** - For complex forms
+2. **Framer Motion** - For animations
+3. **date-fns** - For date manipulation
+4. **Zustand** - For global state (if needed)
+
+### Full-Featured Setup
+For a production-ready application:
+1. All essential additions above
+2. **Vitest + Testing Library** - For testing
+3. **TanStack Table** - For data tables
+4. **Auth.js or Clerk** - For authentication
+5. **Recharts** - For data visualization
+6. **React Dropzone** - For file uploads
+
+## Usage Examples
+
+### Adding shadcn/ui Components
+
+The starter is configured for shadcn/ui. Add components via CLI:
+
+```bash
+# Add specific components
+pnpm dlx shadcn@latest add button
+pnpm dlx shadcn@latest add card dialog form input
+
+# View all available components
+pnpm dlx shadcn@latest add
+```
+
+### Using TanStack Query
+
+Example of data fetching with TanStack Query:
+
+```typescript
+import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query';
+
+// Fetch data
+function MyComponent() {
+  const { data, isLoading, error } = useQuery({
+    queryKey: ['todos'],
+    queryFn: () => fetch('/api/todos').then(r => r.json()),
+  });
+
+  // Mutations
+  const queryClient = useQueryClient();
+  const mutation = useMutation({
+    mutationFn: (newTodo) => fetch('/api/todos', {
+      method: 'POST',
+      body: JSON.stringify(newTodo),
+    }),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: ['todos'] });
+    },
+  });
+}
+```
+
+## Path Aliases
+
+The project already has `@` configured as an alias:
+
+```typescript
+import { cn } from '@/lib/utils';
+import { Button } from '@/components/ui/button';
+import { HomePage } from '@/pages/home/HomePage';
+```

package/templates/frontend/src/docs/SETUP_SUMMARY.md

@@ -0,0 +1,162 @@
+# Frontend Starter Kit - Setup Summary
+
+## What Was Done
+
+### ✅ Replaced ESLint with Biome
+- Removed all ESLint dependencies and configuration
+- Added Biome 2.3.7 with proper configuration
+- Updated scripts: `lint`, `lint:fix`, `format`
+
+### ✅ Updated All Packages to Latest
+Used `npm-check-updates` to update all dependencies:
+- React 19.2.0
+- Tailwind CSS 4.1.17 (major upgrade from v3)
+- TanStack Query 5.90.10
+- React Router 7.9.6
+- Radix UI components (latest)
+- And many more...
+
+### ✅ Added Essential UI Libraries
+
+#### Dependencies
+- `@radix-ui/*` - Accessible component primitives (for shadcn/ui)
+- `@tanstack/react-query` + devtools - Data fetching and caching
+- `class-variance-authority` - For component variants
+- `clsx` - Classname utility
+- `drizzle-orm` - Type-safe database ORM
+- `lucide-react` - Icon library
+- `react-router-dom` - Client-side routing
+- `tailwind-merge` - Merge Tailwind classes
+- `tailwindcss-animate` - Animation utilities
+- `zod` - Schema validation
+
+#### Dev Dependencies
+- `@biomejs/biome` - Linter and formatter
+- `@tailwindcss/postcss` - Tailwind v4 PostCSS plugin
+- `autoprefixer` - CSS autoprefixer
+- `drizzle-kit` - Drizzle ORM CLI
+- `tailwindcss` - Utility-first CSS framework
+
+### ✅ Configured for shadcn/ui
+- Created `components.json` for shadcn CLI
+- Set up path aliases (`@/` → `src/`)
+- Configured Tailwind with shadcn-compatible theme variables
+- Components can be added via: `pnpm dlx shadcn@latest add button`
+
+### ✅ Set Up Modern Build Stack
+- Tailwind CSS v4 with new `@theme` directive
+- PostCSS with proper autoprefixer
+- Path aliases in both TypeScript and Vite
+- Proper ES module syntax throughout
+
+### ✅ Added  Folder Structure
+
+```
+src/
+├── components/
+│   ├── layout/
+│   │   └── Layout.tsx          # Main layout with navigation
+│   └── ui/                     # (empty - add shadcn components here)
+├── hooks/                      # (empty - for custom hooks)
+├── lib/
+│   ├── api-client.ts           # HTTP client helper
+│   └── utils.ts                # cn() helper for classnames
+├── pages/
+│   ├── home/
+│   │   └── HomePage.tsx        # Home page with TanStack Query example
+│   └── about/
+│       └── AboutPage.tsx       # About page
+├── App.tsx                     # Main app with React Router
+├── main.tsx                    # Entry point with providers
+└── index.css                   # Global styles + Tailwind v4 theme
+```
+
+### ✅ Added Configuration Files
+- `biome.json` - Biome linter/formatter config
+- `tailwind.config.js` - Tailwind v4 config
+- `postcss.config.js` - PostCSS with Tailwind plugin
+- `components.json` - shadcn/ui CLI config
+- `.env.example` - Environment variables template
+
+### ✅ Created Documentation
+- `README.md` - Complete setup and usage guide
+- `RECOMMENDED_LIBRARIES.md` - Additional libraries to consider
+
+## Quick Start
+
+1. **Install dependencies:**
+   ```bash
+   cd frontend
+   pnpm install
+   ```
+
+2. **Start development server:**
+   ```bash
+   pnpm dev
+   ```
+
+3. **Add shadcn/ui components:**
+   ```bash
+   pnpm dlx shadcn@latest add button card dialog
+   ```
+
+## Scripts Available
+
+- `pnpm dev` - Start development server
+- `pnpm build` - Build for production
+- `pnpm preview` - Preview production build
+- `pnpm lint` - Check code with Biome
+- `pnpm lint:fix` - Fix linting issues
+- `pnpm format` - Format code
+
+## Important Notes
+
+### Tailwind CSS v4
+This project uses Tailwind CSS v4, which has some changes from v3:
+- Uses `@import 'tailwindcss'` instead of `@tailwind` directives
+- Theme configuration uses `@theme` directive in CSS
+- Requires `@tailwindcss/postcss` plugin
+- Colors are prefixed with `--color-*` in the theme
+
+### shadcn/ui
+Components are NOT pre-installed. Add them as needed:
+```bash
+pnpm dlx shadcn@latest add <component-name>
+```
+
+Components will be added to `src/components/ui/` and can be customized.
+
+### Path Aliases
+Use `@/` to import from src directory:
+```typescript
+import { cn } from '@/lib/utils';
+import { Button } from '@/components/ui/button';
+```
+
+## Testing the Setup
+
+Build completed successfully! ✅
+- TypeScript compilation: ✅
+- Vite build: ✅
+- Total build size: ~262KB (gzipped: ~83KB)
+
+## Next Steps
+
+1. Review the folder structure and example pages
+2. Add shadcn/ui components as needed
+3. Check `RECOMMENDED_LIBRARIES.md` for additional tools
+4. Customize the theme in `src/index.css`
+5. Add your API endpoints and data fetching logic
+
+## Tech Stack Summary
+
+- ⚛️ React 19 + TypeScript
+- 🎨 Tailwind CSS v4
+- 🎯 shadcn/ui (Radix UI + Tailwind)
+- 🔄 TanStack Query v5
+- 🗺️ React Router v7
+- 🗄️ Drizzle ORM
+- 🧹 Biome (linting + formatting)
+- ⚡ Vite 7
+- 🔤 Lucide React (icons)
+- ✅ Zod (validation)

package/templates/frontend/src/hooks/use-scroll.ts

@@ -0,0 +1,21 @@
+import { useCallback, useEffect, useState } from "react";
+
+export function useScroll(threshold: number) {
+  const [scrolled, setScrolled] = useState(false);
+
+  const onScroll = useCallback(() => {
+    setScrolled(window.scrollY > threshold);
+  }, [threshold]);
+
+  useEffect(() => {
+    window.addEventListener("scroll", onScroll);
+    return () => window.removeEventListener("scroll", onScroll);
+  }, [onScroll]);
+
+  // also check on first load
+  useEffect(() => {
+    onScroll();
+  }, [onScroll]);
+
+  return scrolled;
+}