Core Capabilities & Architecture

Everything You Need to Standardize CI/CD

`@waiyat/devops` consolidates pre-flight diagnostics, workflow scaffolding, and centralized reusable GitHub Actions into a zero-config CLI.

1. Pre-Flight CI/CD Diagnostics

Instant inspection of package manifests, Git state, package managers, and container setups.

npx @waiyat/devops@latest check

Evaluates your repository before commits or CI deployments. Inspects package.json health, Git version control initialization, package manager detection (npm, pnpm, yarn, bun), TypeScript compiler options, and Dockerfile presence.

Key Capabilities:

Package manifest inspection and auto-detection of active package manager

Git repository tracking and version control verification

TypeScript tsconfig.json configuration probe

Dockerfile presence and container configuration inspection

CLI Output Preview

Terminal Output

🔍 Running DevOps Pre-Flight Diagnostics...

✅ [INFO] Package manifest detected (package.json found).
✅ [INFO] Git version control initialized.
✅ [INFO] Package Manager: pnpm detected.
✅ [INFO] TypeScript Configured: tsconfig.json present.
✅ [INFO] Dockerfile Present: Multi-stage build configured.

----------------------------------------
Status: 🟢 All Pre-Flight Quality Checks Passed!

2. Intelligent Workflow Scaffolding

Scaffold hardened GitHub Actions pipelines in one command.

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

Generates tailored `.github/workflows/ci.yml` files configured with your package manager, target Node.js version, and reusable quality gates. Supports Next.js, standard Node.js, Docker, monorepos, and full enterprise stacks.

Key Capabilities:

Templates: nextjs, node, docker, monorepo, full

Automatic package manager resolution (pnpm, npm, yarn, bun)

Configurable target Node.js version (--node 22)

Preview YAML before writing to disk using `--dry-run`

CLI Output Preview

Terminal Output

🚀 @waiyat/devops CLI - Centralized DevOps & CI/CD Automation Engine

⚙️  Detecting project environment...
   ✔ Framework: Next.js (App Router)
   ✔ Package Manager: pnpm
   ✔ Node.js Target: v22

📝 Generating .github/workflows/ci.yml using template 'nextjs'...
   ✔ Injected uses: Waiyat/devops/.github/workflows/reusable-ci.yml@main

✨ Successfully created .github/workflows/ci.yml

3. Enterprise Reusable Workflows

Call centralized, production-grade workflows directly from Waiyat/devops.

npx @waiyat/devops@latest list

Eliminates the need to maintain hundreds of lines of complex workflow YAML across repositories. Reference centralized workflows maintained in `Waiyat/devops` directly via GitHub Actions `uses:` syntax.

Key Capabilities:

`reusable-ci.yml`: Multi-runtime quality gate (typecheck, linting, build, test, audit, coverage)

`reusable-cd-docker.yml`: Multi-arch Docker buildx (amd64/arm64) & GHCR / DockerHub publishing

`reusable-release.yml`: Conventional commits, automated changelogs, and GitHub releases

`reusable-security.yml`: Aqua Security Trivy SAST & GitLeaks secret scanner

CLI Output Preview

Terminal Output

📦 Available Enterprise Reusable Workflows in Waiyat/devops:

  1. Reusable CI Quality Gate:
     uses: Waiyat/devops/.github/workflows/reusable-ci.yml@main

  2. Reusable Docker Container CD:
     uses: Waiyat/devops/.github/workflows/reusable-cd-docker.yml@main

  3. Reusable Semantic Release:
     uses: Waiyat/devops/.github/workflows/reusable-release.yml@main

  4. Reusable DevSecOps & Vulnerability Scan:
     uses: Waiyat/devops/.github/workflows/reusable-security.yml@main

4. Multi-Arch Container Deployment

Multi-platform Docker Buildx and GitHub Container Registry (GHCR) publishing.

npx @waiyat/devops@latest init --template docker --docker-image ghcr.io/org/app

Scaffolds complete container build pipelines leveraging Docker Buildx, multi-architecture emulation (`linux/amd64`, `linux/arm64`), and GitHub Actions caching for 3x faster container compilation.

Key Capabilities:

Multi-architecture container builds (amd64 and arm64)

Automated push to GitHub Container Registry (GHCR) and Docker Hub

Layer caching via GitHub Actions cache backend

Non-root least-privilege container execution

CLI Output Preview

Terminal Output

🐳 Configuring Docker Container CD Pipeline...
   ✔ Target Image: ghcr.io/myorg/myapp
   ✔ Architectures: linux/amd64, linux/arm64
   ✔ Registry: GitHub Packages (ghcr.io)
   ✔ Layer Cache: GitHub Actions cache backend enabled

✨ Generated .github/workflows/ci.yml with container publish gate

Ready to scaffold CI/CD in your repository?

Explore all CLI options, templates, and flags in the Commands guide.

View CLI Commands