Example Project

What this is

A scaffold entry that demonstrates every field the project schema validates, so a new project page can be created by copying this file and filling in the real values.

Project status model

Projects surface four signals so a reader can decide, in seconds, how to engage:

1. Stage — where the project is in its lifecycle: concept, building, alpha, beta, stable, paused, archived. stable requires a version.
2. Health — activity indicator derived from updated: fresh (<30d), active (<90d), idle (<365d), cold (>365d).
3. Roadmap — checkbox list in frontmatter; rendered as a progress bar + checklist. The next unchecked item shows on the card.
4. Looking for — call to action: users, contributors, feedback, testers. Renders an accent banner on the project page.

Frontmatter reference

title: "Project Name"
stage: concept | building | alpha | beta | stable | paused | archived
summary: "One or two sentences."
tech: [python, go, sqlite]

started:  "YYYY-MM"      # required
updated:  "YYYY-MM"      # optional — drives the health indicator
released: "YYYY-MM"      # optional — first stable release

version: "0.3.2"         # required when stage is 'stable'

roadmap:
  - { done: true,  text: "Milestone one" }
  - { done: false, text: "Milestone two", note: "optional inline note" }

looking_for: [users, contributors, feedback, testers]

repo:   https://github.com/owner/name
demo:   https://demo.example.com
docs:   https://docs.example.com
paper:  https://arxiv.org/abs/0000.00000
packages:
  - { registry: pypi,      name: package-name }
  - { registry: npm,       name: package-name }
  - { registry: dockerhub, name: owner/image  }

featured: false

Body content

Everything below the frontmatter is free-form MDX: problem framing, architecture notes, diagrams, code snippets, results, links to related journal posts. Replace this scaffold with the real project description.