cistackVersion 3.0.0Stabil

Live aus der Registry

GitHub Actions CI/CD-Pipelines generieren – durch Analyse des Codes, den Sie bereits haben.

cistack scannt Ihr Projekt, erkennt den Stack und schreibt produktionsreife GitHub Actions-Workflows für CI, Deployment, Docker und Releases. Für echte Repos gedacht, nicht für Demos: Es liest Lockfiles, Framework-Signale, Release-Konfiguration, Monorepo-Workspaces, Hosting und Git-Branch-Metadaten, bevor YAML erzeugt wird.

Wöchentliche Downloads

2.4k

letzte Woche auf npm

Schnellstart

npx cistack

Installation

Empfohlen
npx cistack

Holt stets die neueste Version. Keine globale Installation.

cistack unterstützt Node.js 16+; das Projekt wird kontinuierlich auf Node.js 18, 20 und 22 in GitHub Actions geprüft.

Lauf-Vorschau

Animierte CLI-Ausgabe nach dem Scannen eines typischen Projekts.

Ausgabe wird verarbeitet…
npx cistack
$npx cistack
  cistack v3.0.0
  ────────────────────────

✔ Project scanned
✔ Stack detected

  Stack detection summary
  Languages:           TypeScript
  Frameworks:          Next.js
  Hosting:             Vercel
  Testing:             None
  Release tool:        None

Does this look correct? Generate pipeline with these settings? Yes
✔ Generated 1 workflow file
  ✔ Written:      .github/workflows/pipeline.yml
  ✔ Written:      .github/dependabot.yml

Done! Your GitHub Actions pipeline is ready.
   Pipeline → .github/workflows/pipeline.yml
   Dependabot → .github/dependabot.yml

Referenz

Warum cistack

  • Erkennt automatisch Sprachen, Frameworks, Testtools, Hosting-Anbieter und Release-Tools
  • Nutzt den Standard-Git-Branch des Repos, sofern verfügbar, statt main anzunehmen
  • Unterstützt Monorepos, Workflows pro Paket und paketmanagerbewusste Befehle
  • Erzeugt ökosystembewusste Dependabot-Konfiguration, einschließlich Bun bei vorhandenem bun.lock
  • Intelligentes Zusammenführen generierter Workflows mit vorhandenen Dateien statt blindes Überschreiben
  • Erzeugt Deploy-Pipelines für Vercel, Netlify, Firebase, GitHub Pages, AWS, Azure, Heroku, Render und Railway
  • Enthält eingebaute Befehle zum Audit und Upgrade von Workflows
  • Typisierte cistack.config.js-Unterstützung über index.d.ts
  • Abgesichert durch automatisierte Regressionstests (Branches, Release, Smart Merge, Monorepo-Skripte, CLI-Smoke-Tests)

CLI-Nutzung

Was wird generiert

Unterstützte Erkennung

FirebaseVercelNetlifyGitHub PagesAWSGCP App EngineAzureHerokuRenderRailwayDocker

Unterstützte Konfigurationsschlüssel (Top-Level)

  • nodeVersion
  • packageManager
  • hosting
  • frameworks
  • testing
  • branches
  • workflowLayout
  • cache
  • monorepo
  • release
  • secrets
  • outputDir

Branch-Verhalten

  • Ist branches in der Config gesetzt, verwendet cistack diese exakt
  • Andernfalls wird der Standard-Branch aus Git-Metadaten gelesen, sofern verfügbar
  • Ohne Git-Metadaten fallen sichere Defaults wie main, master und develop je nach Workflow-Typ zurück

Konfiguration

Legen Sie cistack.config.js an, um die Erkennung zu überschreiben.

Beispiel

/** @type {import('cistack').Config} */
module.exports = {
  nodeVersion: '20',
  packageManager: 'pnpm',
  branches: ['main', 'staging'],
  workflowLayout: 'single',
  hosting: ['Vercel'],
  outputDir: '.github/workflows',
  cache: {
    npm: true,
    cargo: true,
    pip: true,
  },
  monorepo: {
    perPackage: true,
  },
  release: {
    tool: 'semantic-release',
  },
};

Secrets

Generierte Deploy- und Release-Workflows listen benötigte Secrets am Dateianfang. In GitHub unter Einstellungen → Secrets and variables → Actions hinterlegen.

Prüfungen lokal ausführen

npm test
npm run test:smoke
node bin/ciflow.js audit --path .
node bin/ciflow.js upgrade --path . --dry-run

Beim veröffentlichten Paket lautet das Kommando cistack. Im cistack-Repository ist der lokale Einstieg bin/ciflow.js.

Entwicklung und Qualität

Das Projekt enthält eine Regressionssuite für historisch fehleranfällige Bereiche:

  • Behandlung von Config-Overrides
  • Erkennung des Standard-Branches
  • Auswahl des Deploy-Branches
  • Netlify-Produktions-Branch
  • Smart-Merge-Verhalten
  • Monorepo: Build-Skript pro Paket
  • Release-Konfigurationserkennung
  • Generierung des Release-Workflows
  • CLI-Dry-Run-Smoke-Tests

MIT-Lizenz

CI/CD-Workflow-Generierung aus dem Repo, das Sie bereits haben.

Erstellt von Edwin Vakayil

© 2026 cistack. Alle Rechte vorbehalten, soweit zutreffend.