Skip to main content

​
Overview

The TailStack Core package is the flagship monorepo architecture template that combines the React frontend and Node.js backend into a unified, production-grade development environment. It implements the proven TailStack Architecture with industry-standard tooling, rigorous linting, and automated workflows.

Key Benefits

  • Complete full-stack monorepo architecture
  • Pre-configured development tooling and automation
  • Built-in security and performance optimizations
  • Cross-platform automation scripts
  • AI agent skills for enhanced development

​
Package Information

{
  "name": "your-project-name",
  "version": "1.0.0",
  "packageManager": "[email protected]",
  "license": "MIT"
}

​
Project Structure

core/
├── assets/                 # Static assets (images, logos)
├── Docs/                   # Application & Community documentation
│   ├── CODE_OF_CONDUCT.md
│   ├── CONTRIBUTING.md
│   └── SECURITY.md
├── scripts/                # Cross-platform automation scripts
│   ├── clean.ps1           # PowerShell: Lightning-fast node_modules purge
│   ├── clean.sh            # Shell: Lightning-fast node_modules purge
│   ├── install.ps1         # PowerShell: Parallel pnpm installer
│   └── install.sh          # Shell: Parallel pnpm installer
├── source/
│   ├── frontend/           # The Vite+React Client Application
│   │   ├── src/
│   │   │   ├── components/ # Shadcn UI & Custom Components
│   │   │   ├── pages/      # Application pages
│   │   │   └── ...
│   │   └── vite.config.ts
│   └── Server/             # The Express+TS Backend Application
│       ├── src/
│       │   ├── cluster/    # Node Cluster logic
│       │   ├── routes/     # API Routes
│       │   └── ...
│       └── tsconfig.json
├── .husky/                 # Git hooks configuration
├── .nvmrc                  # Node version specification (24.13.0)
└── package.json

​
Features

​
Frontend Stack

Vite

Next-generation frontend tooling with lightning-fast HMR

React 19

Latest version of the world’s most popular UI library

Tailwind CSS 4

Utility-first CSS with the new high-performance engine

Shadcn UI

Reusable, accessible, and customizable components

​
Backend Stack

Express 5

Fast, unopinionated web framework for Node.js

TypeScript

Full type safety for reliable and maintainable code

Node Cluster

Multi-core system utilization for maximum performance

Security

Pre-configured CORS and security best practices

​
DevOps Tools

  • Husky: Automated pre-commit hooks for code quality
  • Commitlint: Enforces Conventional Commits specification
  • Lint-staged: Runs linters on staged files only
  • Gitleaks: Prevents secrets from being committed
TailStack Core includes advanced cross-platform scripts for high-velocity development:
  • clean.ps1 / clean.sh: Two-phase parallel purge of node_modules and lock files
  • install.ps1 / install.sh: Intelligent parallel installer with CPU/RAM monitoring
Both PowerShell and Bash versions are provided for maximum compatibility.
Pre-configured community and contribution documentation:
  • CONTRIBUTING.md: Contribution guidelines and workflows
  • CODE_OF_CONDUCT.md: Community standards
  • SECURITY.md: Security policy and vulnerability reporting

​
Available Scripts

pnpm dev
# Starts both frontend (port 5173) and backend (port 5000) concurrently

​
Dependencies

​
Production Dependencies

The Core package orchestrates the monorepo and does not have production dependencies itself. Dependencies are managed at the frontend and backend package levels.

​
Development Dependencies

{
  "@commitlint/cli": "^20.3.1",
  "@commitlint/config-conventional": "^20.3.1",
  "concurrently": "^9.2.1",
  "gitleaks": "^1.0.0",
  "husky": "^9.1.7",
  "lint-staged": "^16.2.7",
  "nodemon": "^3.1.11"
}

​
Agent Skills

TailStack comes with pre-configured AI agent skills that enhance development with AI-powered tools.

​
What are Agent Skills?

Skills are reusable capabilities for AI agents that provide procedural knowledge for specific tasks. They act as plugins that enable AI agents to write, refactor, and optimize code with domain-specific expertise. Learn more at skills.sh/docs

​
Pre-configured Skills

A comprehensive performance optimization guide for React applications maintained by Vercel.
  • 57 rules across 8 categories
  • Prioritized by impact
  • Guides automated refactoring and code generation
Official Documentation
Comprehensive guidance for building scalable, maintainable, and production-ready Node.js backend applications.
  • Modern frameworks and architectural patterns
  • Best practices for Express and Node.js
  • Production deployment strategies
Official Documentation
Enables AI agents to correctly generate and work with shadcn/ui components and Tailwind CSS v4.
  • Understands nuances of both technologies
  • Ensures idiomatic and production-quality results
  • Component generation and modification
Official Documentation

​
Supported AI Agents

  • Gemini
  • Claude
  • Codex
  • Cursor
  • OpenCode
  • Trae

​
Automation Scripts

​
Smart Clean Script

./scripts/clean.sh
Features:
  • High-velocity two-phase parallel purge
  • Removes all node_modules and pnpm-lock.yaml files
  • Forcefully kills locking processes (Node, VS Code)
  • 3-retry verification loop for stubborn files

​
Smart Install Script

./scripts/install.sh
Features:
  • Parallel installation across all monorepo packages
  • Intelligent CPU and RAM monitoring
  • Automatic suspension if system load exceeds 90%
  • Resumes when load drops below 75%
  • Prevents system hangs during heavy dependency resolution

​
Environment Configuration

Node.js Version

TailStack Core is configured to use Node.js 24.13.0 as specified in .nvmrc

​
Node Version Manager Setup

nvm use
# Automatically switches to the version in .nvmrc

​
Getting Started

​
Initial Setup

  1. Clone the repository 
    git clone <your-repo-url>
cd core
  2. Install dependencies 
    pnpm install
# or use the smart install script
./scripts/install.sh
  3. Initialize git hooks 
    pnpm husky
  4. Start development 
    pnpm dev

​
Development Workflow

  • Frontend: Access at http://localhost:5173
  • Backend API: Running on http://localhost:5000
  • Both servers support hot module replacement (HMR)

​
Git Workflow

​
Commit Standards

TailStack Core enforces Conventional Commits specification: 
feat: add new feature
fix: resolve bug
docs: update documentation
refactor: restructure code
test: add tests
chore: update build scripts

​
Pre-commit Checks

Automated checks run on every commit:
  • Gitleaks: Scans for hardcoded secrets
  • Lint-staged: Runs linters on staged files
Commits will be rejected if they contain potential secrets or fail linting checks.

​
Package Manager

TailStack Core uses pnpm 10.12.1 for efficient dependency management:
  • Faster than npm and yarn
  • Disk space efficient with content-addressable storage
  • Strict dependency resolution
  • Built-in monorepo support

​
Next Steps

React Package

Explore the frontend architecture and components

Node Package

Learn about the backend API structure

Deployment

Deploy your TailStack application

GitHub Repository

Contribute to the TailStack project

Build docs developers (and LLMs) love

Get started for freeTalk to us