tsdevstack

Infrastructure as Framework

From zero to production in an hour, not months.

tsdevstack is an open-source full-stack framework you install. It generates production code and infrastructure you own.

Local Docker stackMicroservices + SPAsDatabase + migrationsWorkers + scheduled jobsAPI gatewayMulti-cloud TerraformObservabilityDNS + WAFCloud secrets54-tool MCP server

$npx @tsdevstack/cli init

Get Started Why tsdevstack?

Discord Contact

Scaffold a new tsdevstack fullstack-auth project end-to-end, fully non-interactively:

1. Ask me for a project name in lowercase kebab-case (e.g. `my-app`). I'll refer to it below as <PROJECT_NAME>.
2. Make sure Docker Desktop is running (the init step starts local infrastructure).
3. Run `npx --yes @tsdevstack/cli init --name <PROJECT_NAME> --template fullstack-auth --frontend-name frontend`. The `--yes` skips npx's "Ok to proceed?" prompt; the three flags skip the interactive name/template/frontend prompts. This scaffolds the project (NestJS auth-service + Next.js frontend + Kong + Postgres + Redis), installs dependencies, builds shared libs, generates Kong/docker-compose configs, brings up local infra, and creates the initial database migration.
4. `cd <PROJECT_NAME>` and run `npm run dev` to start all services with hot reload.
5. Verify the Kong gateway responds at http://localhost:8000 and the auth-service Swagger UI renders at http://localhost:3001/api.
6. Wire up the built-in tsdevstack MCP server so I can use you for everything that follows (adding services, deploying, secrets management, etc.). Create or update `.mcp.json` in the project root with:

```json
{
  "mcpServers": {
    "tsdevstack": {
      "command": "npx",
      "args": ["tsdevstack", "mcp:serve"]
    }
  }
}
```

7. Install the tsdevstack agent skills for yourself, so framework-specific guidance triggers automatically as you work: from the project root run `npx --yes skills add tsdevstack/skills -a <AGENT_ID> -y`, replacing <AGENT_ID> with your agent id (`claude-code` for Claude Code, `cursor` for Cursor, `codex` for Codex).

Then tell me to restart my AI client so it picks up the new MCP server and skills.

Infrastructure as Framework

Infrastructure as Code

Describe cloud resources in files you commit and apply.

Platform as a Service

Hide cloud resources behind a hosted runtime.

Infrastructure as Framework

Declare services and capabilities in one config. The framework generates the infrastructure code, and you own it.

No hosted platform, no vendor lock-in.

Deploy to any major cloud provider

What you get

Two layers, both driven by one config: a runtime library you import into your services, and infrastructure files the CLI generates for local and cloud.

Runtime modules

@tsdevstack/nest-common

Authentication (JWT, Kong user injection)
Database with Prisma and migrations
Logging, Prometheus metrics, OpenTelemetry tracing
BullMQ workers and scheduled jobs
Storage (S3 / GCS / Azure Blob)

Generated infrastructure

From config.json + infrastructure.json

Local Docker Compose (Postgres, Redis, Kong, MinIO)
Kong gateway routes from OpenAPI specs
Terraform for GCP, AWS, or Azure
GitHub Actions CI/CD workflows
Cloud secrets, DNS, WAF

One config. Full infrastructure.

You define your project. The framework generates Terraform, Docker Compose, Kong routes, CI/CD pipelines, and secrets.

config.json

{
  "projectName": "my-saas",
  "cloud": "gcp",
  "services": [
    {
      "name": "auth-service",
      "type": "nestjs",
      "hasDatabase": true
    },
    {
      "name": "frontend",
      "type": "nextjs"
    }
  ],
  "storage": {
    "buckets": ["uploads"]
  }
}

Generated infrastructure

TerraformVPC, Cloud SQL, Redis, Cloud Run, IAMDocker ComposePostgres, Redis, Kong, MinIO, servicesKong GatewayRoutes from OpenAPI, JWT validation, rate limitingObservabilityPrometheus, Grafana, Jaeger, structured loggingCI/CDGitHub Actions workflows, OIDC auth, per-service deploySecretsJWT keys, API keys, DB URLs — local and cloudWAFCloud Armor / AWS WAF / Front Door rulesStorageS3 / GCS / Azure Blob + MinIO for local dev

Built for AI agents

MCP server with 54 tools. Your AI agent understands the framework, deploys services, configures infrastructure, and manages secrets without hallucinating CLI commands.

Multi-cloud infrastructure

GCP, AWS, Azure. Same framework, generated Terraform, CI/CD pipelines.

Free & open source

No registration needed. Bring your own cloud account. No vendor lock-in, no platform fees. You only pay your cloud provider.

Production-grade by default

OWASP-aligned authentication, observability (Prometheus, Grafana, Jaeger), and compliance controls (SOC 2, ISO 27001, GDPR) wired in. No extra setup.

GitHub npm Discord X Medium dev.to

Watch the demo — 90s