​

CrateStack

CrateStack is a Rust-native, schema-first framework for building typed PostgreSQL-backed services from .cstack files.

​

Why CrateStack

CrateStack is for teams that want one schema to drive:

1. typed SQLx-backed delegates
2. generated API contracts
3. policy-aware server behavior
4. generated Rust and Dart client surfaces

​

What You Get

The verified current slice is strongest at:

1. compile-time schema validation with include_schema!
2. generated SQLx-backed model delegates
3. generated Axum CRUD and procedure routes
4. host-owned auth with generated policy enforcement
5. generated Rust and Dart client surfaces

​

Product Boundaries

The implementation is still narrower than the broader target architecture. Current gaps that matter when adopting it:

1. COSE transport is not implemented yet
2. the client runtime is still a partial spike
3. the parser still covers an initial schema subset
4. some exposure and field-level policy controls are still deferred

​

Documentation Track

The public docs currently publish one active track:

1. v0 for the current product shape and implementation-aligned docs

See overview/release-track for the naming and stability rules behind that track.

​

Start Here

1. overview/current-state for the verified current-state summary
2. getting-started/quickstart for a minimal generic setup path
3. guides/auth-provider for the host auth boundary
4. architecture/transport-architecture for transport model decisions

​

Key Areas

1. guides/ for operational usage boundaries such as auth and telemetry
2. architecture/ for transport and runtime design
3. reference/ for supported auth and policy behavior
4. internals/ for ADRs, PRD material, and dependency decisions

​

Repository Note

This documentation tree is organized as a standalone Mintlify project. The framework code lives in the separate git@github.com:vaam-store/cratestack.git repository.

​

Rust API Docs

The generated Rust documentation is published at https://rust-doc.cratestack.dev/.