# Examples

Self-contained projects, ordered from simplest to most full-featured. Each example has its own README explaining what it shows.

| Example | What it shows |
|---|---|
| [hello-world](hello-world/) | The minimum: `project.cpp` + `main.cpp` |
| [with-module](with-module/) | Adding a C++ module interface |
| [library](library/) | Library + executable, linked via `cfg.dependencies` |
| [tests](tests/) | Auto-discovered tests + tests that link the parent library |

Each example builds standalone: `cd examples/<name> && crafter-build`. Test examples: `crafter-build test`.