A modern Web App Starter Kit based on Tanstack Starter using React, shadcn/ui and Tailwind CSS 4
- TanStack Start RC1 - Modern full-stack React framework
- shadcn/ui - Beautiful, accessible component library
- Tailwind CSS v4 - Modern utility-first CSS framework
- TypeScript - Full type safety
- TanStack Router - Type-safe file-based routing
- Browser Echo - Advanced client-side logging and debugging
- Unplugin Icons - Automatic icon loading and optimization
- Node.js 18+
- pnpm (recommended package manager)
# Clone the starter template (replace with your repo) npx gitpick [email protected]:instructa/constructa-starter-min.git my-app cd my-app
Recommended: This starter uses gitpick for easy cloning without
.gitdirectory, making it perfect for creating new projects from this template.
# Install dependencies pnpm install # Start development server pnpm dev
# Development pnpm dev # Start development server pnpm build # Build for production pnpm start # Start production server # Code Quality pnpm biome:check # Check code formatting and linting pnpm biome:fix:unsafe # Fix code issues (unsafe)
src/
āāā app/
ā āāā routes/ # File-based routing
ā ā āāā __root.tsx # Root layout
ā ā āāā index.tsx # Home page
ā ā āāā api/ # API routes
ā āāā styles/ # Global styles
āāā components/
ā āāā ui/ # shadcn/ui components
āāā utils/ # Utility functions
| Technology | Purpose | Documentation |
|---|---|---|
| TanStack Start RC1 | Full-stack framework | Docs |
| shadcn/ui | Component library | Docs |
| Tailwind CSS v4 | Styling framework | Docs |
| TypeScript | Type safety | Docs |
| Browser Echo | Client-side logging | Docs |
| Unplugin Icons | Icon optimization | Docs |
# Add new components
npx shadcn@latest add button
npx shadcn@latest add card
npx shadcn@latest add input- Uses Tailwind CSS v4 with modern CSS-first configuration
- Configured in
app.config.ts - Global styles in
src/app/styles/
- Path aliases:
@resolves to the root./directory - Route files: Must use
.tsxextension
pnpm build
pnpm start
This project is licensed under the MIT License - see the LICENSE file for details.
Built with ā¤ļø using modern React tools