Tutorials

Learn by building

Each tutorial is a GitHub template repo. Click "Use this template" to get your own copy, clone it locally, and follow the walkthrough with Dark Factory pushing real PRs to your repo.

These tutorials teach godark, not a programming language. It doesn't matter if you've never written a line of Go, Python, or TypeScript — godark has. Pick whichever demo looks interesting and focus on the workflow: specs, harnesses, merge strategies, and verification gates. The language is just the vehicle.

Go

Standard Library HTTP Server
Available

The best place to start. Go compiles fast and the toolchain is minimal, so you can focus on learning the Dark Factory workflow — opening PRs, configuring merge strategies, running tests as gates, and integrating with CI — without fighting your build system.

Toolchain
go buildgo testgo vet
Scenarios covered
01
Basic PR workflow Dark Factory creates a branch, opens a PR, gets it merged
02
Manual vs auto merge When to require human approval vs let it land automatically
03
Watch mode Iterating on changes with --watch, seeing live feedback
05
Mechanical verification: test Test suites as merge gates
06
Mechanical verification: build Compiled languages where build must pass before merge
07
CI pipeline integration GitHub Actions required status checks, Dark Factory waiting on CI
View on GitHub

Python

FastAPI
Coming Soon

Covers the full setup experience from scratch — from godark init through defining architecture, conventions, and the Claude harness. Also explores lint enforcement, test gates, and dependency management with Poetry or uv, where getting the tooling right matters most.

Toolchain
pytestruffpoetry / uv
Scenarios covered
01
Basic PR workflow Dark Factory creates a branch, opens a PR, gets it merged
03
Watch mode Iterating on changes with --watch, seeing live feedback
04
Mechanical verification: lint Pre-merge linting gates, how Dark Factory handles failures and retries
05
Mechanical verification: test Test suites as merge gates
10
Dependency updates Adding/upgrading deps, lock file changes
14
Full godark setup walkthrough Complete setup: init → architecture → conventions → configure → harness
Tutorial in progress

Node.js / TypeScript

Express
Coming Soon

The most realistic project setup for teams already shipping TypeScript. Walks through CI pipelines with GitHub Actions, branch protection rules that require reviews and status checks, and monorepo patterns where multiple packages share a single repository.

Toolchain
npmeslintvitesttsc
Scenarios covered
01
Basic PR workflow Dark Factory creates a branch, opens a PR, gets it merged
04
Mechanical verification: lint Pre-merge linting gates, how Dark Factory handles failures and retries
05
Mechanical verification: test Test suites as merge gates
07
CI pipeline integration GitHub Actions required status checks, Dark Factory waiting on CI
08
Branch protection rules Required reviews, status checks, how Dark Factory works within constraints
09
Monorepo considerations Multiple packages/services in one repo
Tutorial in progress

How it works

01

Pick a demo

Choose the project that matches your preferred language and the scenarios you want to learn.

02

Use the template

Click "Use this template" on GitHub to create your own repo with a clean commit history.

03

Follow the README

Clone locally and work through each scenario step-by-step, with Dark Factory pushing to your repo.