Starter Blueprints & Recipes

Starter Blueprints & Real-World Examples

Scaffold production CI/CD workflows and preflight checks in your repository using `@waiyat/devops`.

Next.js Full-Stack Application

Next.js + TypeScript

Complete Next.js App Router project with TypeScript, Tailwind CSS, preflight diagnostics, and automated CI quality gate.

Scaffold / Run Command

Terminal

npx @waiyat/devops@latest init --template nextjs

Features Included

Calls `uses: Waiyat/devops/.github/workflows/reusable-ci.yml@main`

Deterministic lockfile and strict tsconfig validation

Automated preflight checks before production deployments

Project Layout

File Tree

my-nextjs-app/
├── .github/
│   └── workflows/
│       └── ci.yml               # Reusable CI quality gate caller
├── .dockerignore                 # Auto-generated by devops fix
├── .gitignore                    # Updated with .env security rules
├── app/
└── package.json

Docker Containerized Microservice

Docker + GHCR

Production Node.js/Python microservice with multi-stage Docker build, non-root user enforcement, and automated CycloneDX SBOM generation.

Scaffold / Run Command

Terminal

npx @waiyat/devops@latest add docker/build-push

Features Included

Multi-arch container builds (amd64/arm64) using Buildx

Automated CycloneDX SBOM generated with `npx @waiyat/devops sbom`

Aqua Security Trivy image scanning before container registry push

Project Layout

File Tree

microservice/
├── .github/workflows/
│   ├── ci.yml                   # Quality gate workflow
│   └── docker-build.yml         # Reusable Docker CD workflow
├── Dockerfile                   # Multi-stage image with USER nonroot
├── .dockerignore
└── src/

Turborepo Multi-Package Workspace

Turborepo

Centralized DevOps preflight and quality gates across multiple packages in a Turborepo or pnpm workspace.

Scaffold / Run Command

Terminal

npx @waiyat/devops@latest check

Features Included

Workspace-wide dependency and lockfile drift detection

Centralized CI quality gate across apps and shared packages

Zero redundant pipeline maintenance

Project Layout

File Tree

monorepo/
├── .github/workflows/ci.yml
├── apps/
│   ├── web/
│   └── docs/
├── packages/
│   ├── ui/
│   └── config/
├── pnpm-workspace.yaml
└── turbo.json