Skip to main content

​
Quickstart

Get your TailStack project running in minutes. This guide will help you scaffold, install, and start developing with any of the three TailStack templates.
First time here? This quickstart uses the Core monorepo template. For React-only or Node-only setups, see the Installation guide.

​
Get started in 3 steps

1

Scaffold the project

Use degit to create a new project from the Core monorepo template:
npx degit GitCoder052023/TailStack/packages/core my-project
cd my-project
This downloads the complete TailStack Core architecture with a clean Git history.
2

Install dependencies

TailStack uses pnpm for fast, efficient dependency management.
Run the smart install script with load monitoring:
bash scripts/install.sh
Or use pnpm directly:
pnpm install
The smart install scripts automatically monitor CPU and RAM usage, suspending installations if load exceeds 90% and resuming when it drops below 75%.
3

Start development

Start both the frontend and backend servers concurrently:
pnpm dev
Your application is now running:

​
What you just created

Your TailStack Core project includes:

Frontend

  • React 19 with TypeScript
  • Vite 6 for lightning-fast HMR
  • Tailwind CSS 4 with Shadcn UI
  • React Router for navigation
  • Weather app demo

Backend

  • Express 5 with TypeScript
  • Node.js clustering (multi-core)
  • CORS and security middleware
  • Weather API endpoints
  • Environment configuration

Monorepo Tools

  • PNPM workspaces
  • Husky Git hooks
  • Commitlint for conventional commits
  • Gitleaks security scanning
  • Cross-platform automation scripts

AI Agent Skills

  • Vercel React Best Practices
  • Node.js Backend Patterns
  • Tailwind v4 + Shadcn UI
  • Pre-configured for Claude, Cursor, OpenCode

​
Explore the demo

TailStack includes a fully functional Weather App to showcase the architecture:
  1. Navigate to http://localhost:5173/weather
  2. Search for a city or use your current location
  3. Explore the code:
    • Frontend: source/frontend/src/pages/weather.tsx
    • API Routes: source/Server/src/routes/weather.routes.ts
    • Controller: source/Server/src/controller/weather.controller.ts

​
Next steps

Project Structure

Understand the directory organization and file structure

Development Workflow

Learn the development workflow, Git hooks, and best practices

Building with Core

Build your first feature with the monorepo architecture

Deployment

Deploy your TailStack application to production

​
Alternative templates

Not building a full-stack application? Choose a different template:
For frontend-only applications:
npx degit GitCoder052023/TailStack/packages/react my-react-app
cd my-react-app
pnpm install
pnpm dev
Perfect for dashboards, landing pages, and client-side apps.Learn more about the React template →

​
Troubleshooting

Install pnpm globally:
npm install -g pnpm
Or use Corepack (Node.js 16.13+):
corepack enable
corepack prepare pnpm@latest --activate
If port 5173 or 5000 is already in use, you can change the ports:Frontend - Edit source/frontend/vite.config.ts:
server: {
  port: 3000  // Change to your preferred port
}
Backend - Create a .env file in source/Server/:
PORT=4000  # Change to your preferred port
TailStack requires Node.js 20.x or higher. Check your version:
node --version
If using nvm:
nvm use
Or install the correct version:
nvm install 20

​
Get help

GitHub Issues

Report bugs or request features

Installation Guide

Detailed installation instructions

Build docs developers (and LLMs) love

Get started for freeTalk to us