Introduction

NecrassRs is an SDL-first GraphQL server framework for Rust. Your schema defines the public API. Cargo generates Rust contracts and synchronizes resolver declarations. You implement the resolver bodies.

Under active development

The generated API currently supports query fields with String! results and either no arguments or String! arguments. Design documents describe broader targets; they are not claims of completed support.

Start with a working server

Follow the maintained quick start in the repository, or explore the Axum example and Actix Web example.

From schema to implementation

1. Define your API in schema/**/*.graphql.
2. Run cargo build to generate contracts and synchronize src/resolvers.rs.
3. Implement new resolver bodies and run the server.

Retained fields keep their existing method bodies. New fields receive unimplemented!() stubs, which you must implement before calling them. Deleting or renaming a field removes its old resolver method, including its body. See source synchronization for the full ownership contract.

Explore the documentation

• HTTP adapters: Axum and Actix request/response behavior.
• Introspection and GraphiQL: development UI and introspection settings.
• Architecture: crate responsibilities, source ownership, and planned work.
• Specification requirements: conformance targets and acceptance cases.
• Apollo Compiler patch: the maintained dependency changes.
• Default-cycle experiment: algorithms and measurements.

These pages follow the source checkout from which this site is built. Dates and implementation status in the migrated documents are retained; they do not describe a versioned release. Rust API references are available locally with cargo doc --workspace --no-deps --locked --open.