v0.1.0 — Early Development

PROJECT_IGNITER

Analyze your project · compose visual workflows · forge zero-dependency setup scripts

workflow.json — Project Igniter
{
"steps": [
{ "type": "input", "prompt": "Project name" }
{ "type": "check", "condition": "node --version" },
{ "type": "command", "run": "npm install" },
{ "type": "command", "run": "npm run dev" },
]
}

Three Phases, One Pipeline

From raw project to one-command setup — in three steps.

Coming Soon

Project Analyzer

Scans your project directory — package.json, config files, scripts, dependencies — and suggests a starter workflow. No need to model from scratch; the Analyzer detects the setup patterns already in your project.

For maintainers: Maintainers save hours: point Project Igniter at your repo, get a workflow draft that captures your existing setup. Tweak and ship.

Mostly Built

Workflow Composer

Visual tree editor for modeling project setup. 9 step types, drag-to-reorder, recursive branching, 3-panel layout with context variables and property inspector.

For maintainers: Model your entire setup process visually — inputs, commands, checks, conditionals, OS branches. Every step is configurable and the tree structure maps naturally to setup logic.

Mostly Built

Script Forge

Converts visual workflows into zero-dependency Bash and PowerShell scripts. No Node.js, no Tauri, no runtime required — just native shell.

For maintainers: Define separate workflows per environment. Contributors run `bash setup.sh --env dev` or `--env prod`. Drift detection warns when workflows change. Monorepo support built in.

Everything Included

One-Command Setup

Zero to running in a single command.

Cross-Platform

Branch workflows by OS. Generated scripts run everywhere.

JSON Persistence

Workflows stored as JSON — PR-reviewable, version-controlled.

Variables & Context

User input, env vars, and computed values flow across steps.

Recursive Branching

Nest branches within branches. Handle any complexity.

State Persistence

User answers saved locally. Re-run without re-typing.

Tailored Workflows, Per Environment

Define a separate workflow for dev, staging, and production. Contributors pick the right setup with a single flag.

$./setup.sh--env{dev,staging,prod}
dev
  • Check Node.js version meets minimum requirement
  • Install project dependencies
  • Copy .env.example to .env
  • Start dev server with hot reload
./setup.sh --env dev
staging
  • Run full test suite
  • Prompt for release version
  • Build project for staging target
  • Deploy build to staging server
./setup.sh --env staging
prod
  • Check git working tree is clean
  • Prompt for deploy confirmation
  • Build project for production
  • Tag release in git
  • Deploy to production servers
./setup.sh --env prod

How It Works

Analyze → Compose → Forge. A three-phase pipeline from project to one-command setup.

01Coming Soon

Analyze

Project Analyzer

Point the Analyzer at any project directory. It scans package.json, config files, scripts, and dependency manifests to understand your project's setup patterns. The output is a starter workflow — no blank canvas needed.

02Ready

Compose

Workflow Composer

Open the visual tree editor. Drag to reorder steps, add branches for different OSes and conditions, configure properties in the side panel. Every step type maps to a real action: prompt for input, run a command, check a condition, write a file.

03Ready

Forge

Script Forge

Hit generate and the Composer output — a JSON workflow tree — is compiled into zero-dependency Bash and PowerShell scripts. No runtime needed. Commit them to your repo and contributors run `bash setup.sh --env dev` to get started, `--env staging` for pre-release, or `--env prod` for production deployment.

See It in Action

A visual workflow editor that makes setup modeling intuitive.

Workflow Tree Editor

Tree Editor

Drag-to-reorder steps, expand branches, add new steps — all visually.

Properties Panel

Properties Panel

Configure each step's behavior — commands, conditions, inputs, and more.

Context Variables

Context Variables

Track all variables used across steps — inputs, conditions, and outputs.

What's Next

Current status and what's coming down the pipeline.

Script Forge Optimisation

In Progress

The converter works end-to-end: Bash and PowerShell generation, state machine dispatch, drift detection, monorepo support. Current focus is on optimising output quality — cleaner generated scripts, better error handling, faster generation.

Project Analyzer

Coming Next

The Analyzer will scan a project directory and produce a starter workflow. It detects package managers (npm, pip, cargo, etc.), config files, build scripts, and environment requirements. Maintainers get a draft workflow they can refine in the Composer — no need to model from scratch.

  • Detect package manager and dependencies from lock files
  • Identify build/test/lint scripts from package.json / Makefile / Cargo.toml
  • Suggest input prompts for required configuration values
  • Auto-generate OS-aware branches where needed
  • Output a ready-to-edit workflow JSON

Runtime Installer

Planned

Beyond generated shell scripts — a dedicated runtime that executes workflows natively. Rich UI, progress reporting, interactive prompts, and real-time feedback during setup.

Get Project Igniter

Early development — preview builds coming soon. Star the repo to stay updated.

GitHub
Builds will be available on GitHub Releases once ready.

Frequently Asked Questions

What is Project Igniter?
A desktop application that lets maintainers model project setup as visual workflows. These workflows are saved as JSON and can be executed by the runtime installer — turning pages of setup docs into a single command.
Who is it for?
Open-source maintainers who want to reduce onboarding friction, and anyone tired of maintaining setup documentation that goes stale.
How is it different from shell scripts?
Shell scripts are linear and hard to maintain. Project Igniter workflows are visual, support branching (OS, conditions, checks), capture user input, and are version-control friendly as structured JSON.
What platforms are supported?
Project Igniter itself runs on macOS, Linux, and Windows (built with Tauri). Workflows can branch by OS, so you model once and each platform gets the right setup.
Can I have different setups for dev, staging, and prod?
Yes. Define a separate workflow for each environment and tag them in the workflow index. Generated scripts accept an --env flag — contributors run ./setup.sh --env dev for local setup, --env staging for pre-release, or --env prod for production deployment. Each environment runs only its own workflow.
Is it ready to use?
Project Igniter is in early development. The workflow editor is being built — the runtime installer will follow. Star the repo to follow progress.
Can I contribute?
Absolutely! The project is open source. Check the GitHub repo for issues, discussions, and contribution guidelines.