Skip to main content

Development

This is the only top-level section that assumes knowledge of Jiandu internals. Operator guidance elsewhere describes observable behavior and supported workflows.

Jiandu is a Rust modular monolith with a strict TypeScript frontend. Application persistence is backend-neutral, document bytes use content-addressed blob storage, and published API contracts live in the repository's api/ directory.

Start here

  1. Read the repository's Contributing guide.
  2. Use Architecture to locate the owning boundary before editing.
  3. Follow the local environment guide.
  4. Run the verification tier appropriate to the change.
  5. Update public docs when user-visible behavior, commands, configuration, or errors change.

Security reports belong through the process in SECURITY.md, never in a public issue.

:::warning Copyright The repository does not currently contain a LICENSE file. Default copyright applies; do not assume the source can be reused or redistributed. :::