TailStack is a Production-Grade Project Architecture and boilerplate designed to serve as a robust starting point for your ERN (Express, React, Node.js) monorepos.

It implements the TailStack Architecture—a proven structure I personally use for full-stack development—providing a scalable, secure, and maintainable foundation. It includes industry-standard tooling, rigorous linting, and a beautiful UI system, all pre-configured so you can hit the ground running.

Not a rigid framework, TailStack is designed to be fully customizable. Whether you are building a startup MVP or a large-scale enterprise solution, it offers the perfect customizable launchpad to adapt to your specific needs.

Experience a modern, lightning-fast development environment:

• Vite: Next-generation frontend tooling.
• React: Built on the world's most popular UI library.
• Tailwind CSS: Utility-first CSS for rapid UI development.
• Shadcn UI: Reusable, accessible, and customizable components.
• Lucide React: Beautiful & consistent icons.
• Sonner: An opinionated toast component for React.
• React Router: Declarative routing for your application.
• Weather App Demo: Includes a fully functional multi-page weather application to showcase the architecture.

A robust and scalable server-side foundation:

• Express: Fast, unopinionated, minimalist web framework for Node.js.
• TypeScript: Type safety for reliable and maintainable code.
• Node Cluster: Utilizes multi-core systems for maximum performance.
• Security: Pre-configured CORS and security best practices.

TailStack allows you to focus on code, not configuration:

• Commitlint: Enforces Conventional Commits for clean history.
• Husky: Git hooks for pre-commit linting and security checks.
• Automation Scripts: Smart, cross-platform automation utilities for high-velocity development, available for both Windows (PowerShell) and Linux/macOS (Shell). Found in the packages/core/scripts/ directory:
  • clean: Lightning-fast deep purge of node_modules and locks.
  • install: Parallel installer with intelligent CPU/RAM load monitoring.
• Documentation: Ready-to-use CONTRIBUTING.md, CODE_OF_CONDUCT.md, and SECURITY.md.
• Configs: Standardized .npmrc, .nvmrc, and .node-version for consistent environments.

TailStack comes supercharged with pre-configured Agent Skills to accelerate AI-driven development.

Skills are reusable capabilities for AI agents. They provide procedural knowledge that helps agents accomplish specific tasks more effectively. Think of them as plugins or extensions that enhance what your AI agents can do, enabling them to write, refactor, and optimize code with greater precision and domain-specific expertise.

• Read More: https://skills.sh/docs

1. Vercel React Best Practices: A comprehensive performance optimization guide for React and Next.js applications, maintained by Vercel. It contains 57 rules across 8 categories, prioritized by impact to guide automated refactoring and code generation.

• Official Docs: https://skills.sh/vercel-labs/agent-skills/vercel-react-best-practices

2. Node.js Backend Patterns: This Skill is a Comprehensive guidance for building scalable, maintainable, and production-ready Node.js backend applications with modern frameworks, architectural patterns, and best practices.

• Official Docs: https://skills.sh/wshobson/agents/nodejs-backend-patterns

3. Tailwind v4 + shadcn/ui Production Stack: This skill enables AI agents to correctly generate, modify, and work with components from shadcn/ui and the new Tailwind CSS v4 engine. It understands the nuances of both technologies, ensuring idiomatic and production-quality results.

• Official Docs: https://skills.sh/jezweb/claude-skills/tailwind-v4-shadcn

• Gemini
• Claude
• Codex
• Cursor
• Opencode
• Trae

TailStack provides three distinct architecture templates within the packages/ directory:

The flagship TailStack Architecture. A complete monorepo setup featuring an ERN Stack (Express, React, Node.js) with pre-configured inter-service communication, shared configurations, and deployment-ready workflows.

• Best for: Full-stack applications, startups, and complex projects requiring a unified codebase.

A focused frontend project architecture based on Vite + React. It includes a premium UI setup with Tailwind CSS 4, Shadcn UI, and modern routing.

• Best for: Client-side applications, dashboards, and landing pages.

A robust backend foundation using Express + TypeScript. It features advanced Node.js optimizations like clustering, security best practices, and a clean directory structure.

• Best for: REST APIs, microservices, and backend-only utilities.

TailStack includes advanced, cross-platform automation scripts to manage your monorepo efficiently. Both PowerShell (.ps1) and Bash (.sh) versions are provided for key tasks.

A high-velocity two-phase purge that removes all node_modules and pnpm-lock.yaml files.

• Speed: Uses parallel processing for faster deletion.
• Reliability: Forcefully kills locking processes (Node, VS Code) and uses a 3-retry verification loop for stubborn files.

A parallel installer designed for stability on any hardware.

• Parallelism: Installs dependencies for all projects in the monorepo concurrently.
• Load Monitoring: An intelligent state machine monitors CPU and RAM, automatically suspending installation processes if system load exceeds 90% and resuming when it drops below 75%.
• Anti-Crash: Prevents system hangs during heavy dependency resolution.

TailStack is distributed as a set of standalone templates. You can quickly scaffold a new project by pulling a specific architecture directly from the packages/ directory using npx degit or curl. This allows you to start a new project with a clean Git history.

Run the following command in your terminal, replacing <template> with core, react, or node, and <project-name> with your desired folder name.

# Usage: npx degit GitCoder052023/TailStack/packages/<template> <project-name>

# Example: Scaffold the full ERN Monorepo
npx degit GitCoder052023/TailStack/packages/core my-awesome-app

# Example: Scaffold only the React Frontend into the current directory
npx degit GitCoder052023/TailStack/packages/react .

If you don't have Node.js installed or prefer a shell-native way, use this command to download and extract only the specific package:

# Usage: replace <template> with core, react, or node
curl -L https://github.com/GitCoder052023/TailStack/archive/refs/heads/main.tar.gz | tar -xz --strip-components=2 TailStack-main/packages/<template>

If you prefer to explore the entire repository or contribute to the project, you can clone the monorepo manually:

1. Clone the repository:

git clone https://github.com/GitCoder052023/TailStack.git

2. Navigate to your desired architecture:

cd TailStack/packages/[core|react|node]

3. Initialize dependencies: Follow the specific README.md instructions found within each package directory to set up environment and start development within that template.

Contributions are what make the open-source community such an amazing place. We welcome improvements to any of our templates! Please see CONTRIBUTING.md for details.

Built with the TailStack Architecture.