{"id":49534475,"url":"https://github.com/edwinvakayil/cistack","last_synced_at":"2026-05-02T09:05:34.394Z","repository":{"id":349700082,"uuid":"1201801581","full_name":"edwinvakayil/cistack","owner":"edwinvakayil","description":"Generate GitHub Actions CI/CD pipelines by analyzing the codebase you already have.","archived":false,"fork":false,"pushed_at":"2026-04-14T18:51:31.000Z","size":4946,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-14T20:28:15.482Z","etag":null,"topics":["cicd","developer-tools","development","devops","npm-package","pipeline","vercel"],"latest_commit_sha":null,"homepage":"https://cistack.edwinvakayil.info","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/edwinvakayil.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-05T07:13:27.000Z","updated_at":"2026-04-14T18:51:28.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/edwinvakayil/cistack","commit_stats":null,"previous_names":["edwinvakayil/cistack"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/edwinvakayil/cistack","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/edwinvakayil%2Fcistack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/edwinvakayil%2Fcistack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/edwinvakayil%2Fcistack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/edwinvakayil%2Fcistack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/edwinvakayil","download_url":"https://codeload.github.com/edwinvakayil/cistack/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/edwinvakayil%2Fcistack/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32528667,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-02T01:12:54.858Z","status":"online","status_checked_at":"2026-05-02T02:00:05.923Z","response_time":132,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cicd","developer-tools","development","devops","npm-package","pipeline","vercel"],"created_at":"2026-05-02T09:05:21.659Z","updated_at":"2026-05-02T09:05:34.380Z","avatar_url":"https://github.com/edwinvakayil.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# cistack\n\n\u003e Generate GitHub Actions CI/CD pipelines by analyzing the codebase you already have.\n\n`cistack` scans your project, detects the stack, and writes production-ready GitHub Actions workflows for CI, deployment, Docker, and releases. It is designed for real repos, not toy demos: it reads lock files, framework signals, release config, monorepo workspaces, hosting config, and Git branch metadata before generating YAML.\n\n## Why cistack\n\n- Detects languages, frameworks, testing tools, hosting providers, and release tooling automatically\n- Uses your repository's default Git branch when available instead of assuming `main`\n- Supports monorepos, per-package workflows, and package-manager-aware commands\n- Generates ecosystem-aware Dependabot config, including Bun when `bun.lock` is present\n- Smart-merges generated workflows with existing files instead of blindly overwriting them\n- Generates deploy pipelines for Vercel, Netlify, Firebase, GitHub Pages, AWS, Azure, Heroku, Render, and Railway\n- Ships with built-in workflow audit and upgrade commands\n- Includes typed `cistack.config.js` support through `index.d.ts`\n- Backed by an automated regression suite covering branch handling, release detection, smart merge behavior, monorepo package scripts, and CLI smoke tests\n\n## Installation\n\n```bash\n# One-off usage\nnpx cistack\n\n# Global install\nnpm install -g cistack\n```\n\n`cistack` supports Node.js 16+, and the project itself is continuously verified on Node.js 18, 20, and 22 in GitHub Actions.\n\n## Product site\n\nA standalone Next.js marketing app for the product lives in [product-site](/Users/edwinvs/Desktop/NPM/ciflow/product-site/README.md).\n\n## CLI Usage\n\n### Generate workflows\n\n`generate` is the default command, so both of these work:\n\n```bash\nnpx cistack\nnpx cistack generate\n```\n\nCommon options:\n\n```bash\nnpx cistack generate --path /path/to/project\nnpx cistack generate --dry-run\nnpx cistack generate --explain\nnpx cistack generate --output .github/workflows\nnpx cistack generate --no-prompt\n```\n\n### Audit existing workflows\n\n```bash\nnpx cistack audit\n```\n\nThis checks your generated workflow directory for issues like missing concurrency blocks, outdated actions, old Node versions, and missing dependency caching. If you set `outputDir` in `cistack.config.js`, `audit` and `upgrade` will use that directory too.\n\n### Upgrade workflow actions\n\n```bash\nnpx cistack upgrade\nnpx cistack upgrade --dry-run\n```\n\nThis updates known GitHub Actions to their latest supported stable versions.\n\n### Create a starter config\n\n```bash\nnpx cistack init\n```\n\nThis writes `cistack.config.js` with the supported override keys.\n\n## What gets generated\n\n### `pipeline.yml`\n\nBy default, `cistack` now generates a single GitHub Actions workflow that combines CI, deploy, Docker, and release jobs into one place so teams can track the whole pipeline from one file.\n\n- Includes lint, test, build, E2E, deploy, Docker, and release jobs when those parts of the stack are detected\n- Uses the detected default branch or your configured `branches`\n- Keeps preview deploys and release jobs in the same workflow file\n- Documents required secrets in the file header\n\n### `dependabot.yml`\n\nDependabot remains a separate file in `.github/dependabot.yml`, because it is not a GitHub Actions workflow.\n\nIf you want preview deployments on Dependabot pull requests, add deployment credentials as Dependabot secrets too, not only Actions secrets. For Vercel, that means `VERCEL_TOKEN`, `VERCEL_ORG_ID`, and `VERCEL_PROJECT_ID`.\n\n### Split mode\n\nIf you prefer the old multi-file layout, set:\n\n```js\nmodule.exports = {\n  workflowLayout: 'split',\n};\n```\n\nIn split mode, `cistack` writes separate `ci.yml`, `deploy.yml`, `docker.yml`, and `release.yml` files again.\n\n## Supported detection\n\n### Hosting\n\n- Firebase\n- Vercel\n- Netlify\n- GitHub Pages\n- AWS\n- GCP App Engine\n- Azure\n- Heroku\n- Render\n- Railway\n- Docker\n\n### Frameworks\n\n- Next.js\n- Nuxt\n- SvelteKit\n- Remix\n- Astro\n- Vite\n- React\n- Vue\n- Angular\n- Svelte\n- Gatsby\n- Express\n- Fastify\n- NestJS\n- Hono\n- Koa\n- Django\n- Flask\n- FastAPI\n- Rails\n- Spring Boot\n- Laravel\n- Go\n- Rust\n\n### Testing tools\n\n- Jest\n- Vitest\n- Mocha\n- Cypress\n- Playwright\n- Pytest\n- RSpec\n- Go test\n- Cargo test\n- PHPUnit\n- Maven / JUnit\n- Storybook\n\n## Configuration\n\nCreate `cistack.config.js` when you want to override detection:\n\n```js\n/** @type {import('cistack').Config} */\nmodule.exports = {\n  nodeVersion: '20',\n  packageManager: 'pnpm',\n  branches: ['main', 'staging'],\n  workflowLayout: 'single',\n  hosting: ['Vercel'],\n  outputDir: '.github/workflows',\n\n  cache: {\n    npm: true,\n    cargo: true,\n    pip: true,\n  },\n\n  monorepo: {\n    perPackage: true,\n  },\n\n  release: {\n    tool: 'semantic-release',\n  },\n};\n```\n\nSupported top-level config keys:\n\n- `nodeVersion`\n- `packageManager`\n- `hosting`\n- `frameworks`\n- `testing`\n- `branches`\n- `workflowLayout`\n- `cache`\n- `monorepo`\n- `release`\n- `secrets`\n- `outputDir`\n\nBranch behavior:\n\n- If `branches` is set in config, `cistack` uses it exactly\n- Otherwise it reads the repository's default branch from Git metadata when available\n- If Git metadata is unavailable, it falls back to safe defaults like `main`, `master`, and `develop` depending on the workflow type\n\n## Secrets\n\nGenerated deploy and release workflows document the secrets they need at the top of each file. Add them in:\n\n`GitHub -\u003e Settings -\u003e Secrets and variables -\u003e Actions`\n\n## Development and Quality\n\nThe project now includes a regression suite for the areas that were historically the easiest to break:\n\n- config override handling\n- default branch detection\n- deploy branch selection\n- Netlify production branch handling\n- smart merge behavior\n- monorepo per-package build script lookup\n- release config detection\n- release workflow generation\n- CLI dry-run smoke testing\n\nRun the checks locally:\n\n```bash\nnpm test\nnpm run test:smoke\nnode bin/ciflow.js audit --path .\nnode bin/ciflow.js upgrade --path . --dry-run\n```\n\nIf you are using the published package, the executable is `cistack`. In this repository, the local entrypoint is `bin/ciflow.js`.\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fedwinvakayil%2Fcistack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fedwinvakayil%2Fcistack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fedwinvakayil%2Fcistack/lists"}