A scalable monorepo platform for swordstosilenced.com built with TypeScript, optimized for rapid development and deployment.

swords2silenced/
├── apps/                 # Web applications and frontends
│   └── web/             # Main website (swordstosilenced.com)
├── packages/            # Shared libraries and utilities
│   ├── core/           # Core business logic
│   ├── ui/             # Reusable UI components
│   └── api/            # API clients and utilities
├── tools/              # Development tools and scripts
│   ├── cli/            # CLI tools
│   ├── generators/     # Code generators
│   └── mcp/            # MCP skills workspace
└── docs/               # Documentation

• Node.js 18+
• npm 9+

# Install dependencies
npm install

# Build all packages
npm run build

# Run development servers
npm run dev

# Run tests
npm run test

• Fixed Next.js deploy build regression by moving API contract tests from src/pages/api to src/tests/api so route validators only evaluate real API handlers.
• Fixed malformed workspace manifests that blocked npm parsing in CI and local hooks.
• Restored web lint/build stability by resolving merge artifacts and removing unavailable PostCSS plugin requirements.
• Hardened GitHub deploy + CodeQL workflows for current action versions and reliable execution paths.
• Added a new secondary page at /testimony to present a structured personal testimony connected from the homepage.
• Added CHANGELOG.md and bumped project version to 0.1.1.
• Re-validated full root quality gates (test, lint, type-check, build) during failed-testing continuation; all local checks are currently green.

• main: Production-ready code
• develop: Integration branch for features
• feature/: Feature branches (e.g., feature/auth-system)
• bugfix/: Bug fix branches (e.g., bugfix/login-issue)
• hotfix/: Production hotfixes (e.g., hotfix/critical-security)

See BRANCHING_STRATEGY.md for details.

apps/web is configured for Tailwind CSS + PostCSS integration (Tailwind directives are enabled in src/styles/globals.css).

# install workspace deps (run in network-permitted environment)
npm install

# run web app
npm run dev --workspace=apps/web

This project uses npm workspaces. Each workspace has its own package.json:

# Run script in specific workspace
npm run dev --workspace=apps/web

# Install dependency in workspace
npm install axios --workspace=packages/api

• npm run dev - Start development servers
• npm run build - Build all packages
• npm run test - Run all tests
• npm run lint - Lint all packages
• npm run format - Format code with Prettier
• npm run type-check - Run TypeScript type checking
• npm run build --workspace=@swords2silenced/mcp-skills - Build MCP skills workspace
• npm run test --workspace=@swords2silenced/mcp-skills - Run MCP tests (configured to pass when no test files exist)

Deployments are configured through vercel.json in each app:

vercel deploy

Domain: swordstosilenced.com

• Nameservers: Cloudflare
• A Records: Pointing to Vercel deployment

npm run test          # Run all tests
npm run test:watch   # Watch mode
npm run coverage     # Generate coverage report

• Setup Guide - Local development setup
• Deployment Summary - Complete project overview

• Branching Strategy - Git Flow workflow
• Contributing Guidelines - How to contribute

• Deployment Guide - Vercel deployment
• DNS & Cloudflare Setup - GoDaddy to Cloudflare migration
• Skills Integration - Install and use skills
• Agent Handoff - Current blockers, priorities, and next-agent continuity checklist

Please follow our Contributing Guidelines.

MIT - See LICENSE for details.

• Probe URL for hosting health checks: https://<your-domain>/status (rewritten by Next.js to /api/status).
• Response contract always includes status, checks, notes, and version (plus diagnostics and timing metadata for GET requests).
• Non-GET methods return HTTP 405 with Allow: GET and the same top-level contract keys (status, checks, notes, version).
• Set *_EXPIRES_AT environment values alongside rotated secrets to keep diagnostics accurate.