A powerful TypeScript framework for managing GitHub Actions workflows and configurations. DotGitHub provides a type-safe, construct-based approach to generating and managing GitHub Actions, making it easier to maintain complex CI/CD pipelines.
- 🚀 Type-Safe Actions: Generate TypeScript wrappers for GitHub Actions with full type safety
- 🔌 Construct System: Extensible construct architecture for custom workflow generation
- 📦 Action Management: Automatically download and manage GitHub Actions with version pinning
- 🏗️ Workflow Synthesis: Generate complete GitHub workflows from TypeScript code
- 🎯 Configuration-Driven: Declarative configuration for actions, plugins, and stacks
- 🔄 Auto-Generation: Automatically generate action types and workflow files
# Install globally
npm install -g @dotgithub/cli
# Or use with npx
npx @dotgithub/cli# Initialize a new DotGitHub project
dotgithub init
# Or specify a custom directory
dotgithub init --output ./my-workflows# Add a specific action
dotgithub add actions/checkout@v4
# Add multiple actions
dotgithub add actions/setup-node@v4 actions/setup-python@v5# Synthesize workflows from your TypeScript code
dotgithub synth- Initialize your project with
dotgithub init - Configure actions in
dotgithub.json - Write your workflow logic in TypeScript
- Synthesize workflows with
dotgithub synth
We welcome contributions! Please see our Contributing Guide for details on how to get started.
MIT License - see LICENSE file for details.