Concepts & Contribution

Guides & Deep Dives

Understand the compiler model behind Netsuke, learn where the sharp edges are, and use the same language the manifests use.

Architecture

How Netsuke Works

Explore the six-stage pipeline that turns a YAML manifest into a static Ninja plan. The dynamic work happens up front, so execution stays fast and legible.

Manifest Parsing

YAML validation and raw manifest loading

Graph Analysis

Dependency resolution and cycle detection

Action Execution

Generated Ninja execution with clear diagnostics

Read the architecture guide

pipeline_state.rs

fn construct_graph(manifest) -> Graph {

... internal logic ...

Analysis Phase

Execution Phase

}

Input: 14kb Output: Binary

Philosophy & Context

Documentation Hub

Start in the docs hub for the core ideas behind Netsuke, then branch into manifests, templating, and execution details.

Open Docs Hub →

Roadmap & Release Status

See what shipped in v0.1.0-beta3, the known limitations, and the phased plan for the work ahead.

Open Roadmap →

Forthcoming Capabilities

Netsukefile Linter

v0.2.0

What netsuke check will lint, how rule severities are configured, and what the preview deliberately leaves out.

Read the preview →

Testing Framework

v0.4.0

The netsuke test dialect: mocks, fixtures, and assertions over the expanded manifest, graph, and generated Ninja.

Read the preview →

Contributing

Contribution Guidelines

Start here. Code of conduct, setting up your dev environment, and pull request etiquette.

Translating Netsuke

Full localization guide: Fluent files, message keys, plurals, the style guide and glossary, and adding a new locale.

Writing Examples & Showcases

Full guide to contributing example manifests and turning them into showcase pages.

Community Resources

Project Repository

Browse the prototype source, assets, and roadmap in one place.

Open Repository

Issue Tracker

Report bugs, request improvements, and track the prototype backlog.

Open Issues

Roadmap

Follow what shipped, what is still rough, and the phased plan ahead.

View the Roadmap