Skip to content

instructa/constructa-convex-starter

 
 

Repository files navigation

Constructa Starter Min

A modern Web App Starter Kit based on Tanstack Starter using React, shadcn/ui and Tailwind CSS 4

TypeScript React TailwindCSS

✨ Features

🚀 Quick Start

Prerequisites

  • Node.js 18+
  • pnpm (recommended package manager)

Download

# Clone the starter template (replace with your repo) npx gitpick git@github.com:instructa/constructa-starter-min.git my-app cd my-app

Recommended: This starter uses gitpick for easy cloning without .git directory, making it perfect for creating new projects from this template.

Installation

# Install dependencies pnpm install # Start development server pnpm dev

Available Scripts

# 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)

📁 Project Structure

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 

🎯 Core Technologies

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

🔧 Configuration

Adding shadcn/ui Components

# Add new components npx shadcn@latest add button npx shadcn@latest add card npx shadcn@latest add input

Tailwind CSS

  • Uses Tailwind CSS v4 with modern CSS-first configuration
  • Configured in app.config.ts
  • Global styles in src/app/styles/

TypeScript

  • Path aliases: @ resolves to the root ./ directory
  • Route files: Must use .tsx extension

🚀 Deployment

Build for Production

pnpm build

Start Production Server

pnpm start

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.


Built with ❤️ using modern React tools

About

Minimal Tanstack Starter with shadcn, tailwind v4

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • TypeScript 86.6%
  • CSS 8.5%
  • JavaScript 4.9%