# FastQL

> A Python-native GraphQL framework with a unified schema API and built-in execution engine.

## Docs

- [Language pipeline](https://fastql.vachagan.dev/architecture/language-pipeline.md): Follow GraphQL source through lexing, parsing, and AST production.
- [Architecture overview](https://fastql.vachagan.dev/architecture/overview.md): See how FastQL turns Python definitions into GraphQL responses.
- [Type system and schema compilation](https://fastql.vachagan.dev/architecture/type-system.md): Understand registries, type references, and schema construction.
- [Validation and execution](https://fastql.vachagan.dev/architecture/validation-and-execution.md): Trace operation selection, coercion, field collection, and completion.
- [Inputs and abstract types](https://fastql.vachagan.dev/build/inputs-and-abstract-types.md): Model input objects, interfaces, unions, enums, and custom scalars.
- [Naming and configuration](https://fastql.vachagan.dev/build/naming-and-configuration.md): Control GraphQL names while keeping Python definitions idiomatic.
- [Operations and schema](https://fastql.vachagan.dev/build/operations-and-schema.md): Compose query, mutation, and subscription roots into a schema.
- [Types and fields](https://fastql.vachagan.dev/build/types-and-fields.md): Define object types with annotations, Field descriptors, and resolvers.
- [Contributing](https://fastql.vachagan.dev/contribute/contributing.md): Expectations for code, specifications, tests, and documentation.
- [Development setup](https://fastql.vachagan.dev/contribute/development.md): Prepare a local FastQL checkout and run its verification suite.
- [Documentation workflow](https://fastql.vachagan.dev/contribute/documentation.md): Run, validate, and update the Mintlify documentation project.
- [FastQL documentation](https://fastql.vachagan.dev/index.md): Build and execute GraphQL services with Python-native schemas and one coherent API.
- [ASGI, Starlette, and FastAPI](https://fastql.vachagan.dev/integrations/asgi-and-api-frameworks.md): Configure FastQL with async Python web applications.
- [HTTP context](https://fastql.vachagan.dev/integrations/context.md): Access native requests, middleware state, custom values, and response headers.
- [Flask and Django](https://fastql.vachagan.dev/integrations/flask-and-django.md): Mount the async-first FastQL handler in synchronous and async-capable frameworks.
- [GraphQL-over-HTTP contract](https://fastql.vachagan.dev/integrations/http-contract.md): Supported request formats, endpoint options, and adapter extension boundary.
- [Web framework integrations](https://fastql.vachagan.dev/integrations/overview.md): Mount one FastQL schema in ASGI, Starlette, FastAPI, Flask, or Django.
- [Context API](https://fastql.vachagan.dev/reference/context.md): Reference for Context, Info, and dependency registration.
- [Decorators and metadata](https://fastql.vachagan.dev/reference/decorators.md): Reference for schema decorators, Field, Arg, and directives.
- [API overview](https://fastql.vachagan.dev/reference/overview.md): Find the public FastQL APIs by responsibility.
- [Scalars and wrappers](https://fastql.vachagan.dev/reference/scalars-and-wrappers.md): Reference for built-in scalar mappings and explicit type wrappers.
- [Schema and execution](https://fastql.vachagan.dev/reference/schema-and-execution.md): Reference for schema construction, validation, and execution.
- [Context and Info](https://fastql.vachagan.dev/resolve/context-and-info.md): Pass request state and inspect the active GraphQL field.
- [Dependencies](https://fastql.vachagan.dev/resolve/dependencies.md): Inject typed services into resolvers with registered providers.
- [Errors and nullability](https://fastql.vachagan.dev/resolve/errors-and-nullability.md): Understand GraphQL errors, paths, and non-null propagation.
- [Extensions and permissions](https://fastql.vachagan.dev/resolve/extensions-and-permissions.md): Wrap field resolution and enforce declarative access policy.
- [Resolvers](https://fastql.vachagan.dev/resolve/resolvers.md): Implement synchronous and asynchronous field resolution.
- [Capability catalog](https://fastql.vachagan.dev/specifications/capability-catalog.md): Map documented FastQL features to their canonical OpenSpec requirements.
- [Product principles and scope](https://fastql.vachagan.dev/specifications/product-principles.md): The product decisions that guide FastQL development.
- [First schema](https://fastql.vachagan.dev/start/first-schema.md): Add names, descriptions, argument metadata, and schema configuration.
- [Installation](https://fastql.vachagan.dev/start/installation.md): Install FastQL and prepare a supported Python environment.
- [Introduction](https://fastql.vachagan.dev/start/introduction.md): Understand FastQL's Python-native model and where it fits.
- [Project status](https://fastql.vachagan.dev/start/project-status.md): Current FastQL capabilities, boundaries, and maturity.
- [Quickstart](https://fastql.vachagan.dev/start/quickstart.md): Define a schema, execute a query, and inspect the result.
- [CLI](https://fastql.vachagan.dev/tooling/cli.md): Load and serve a FastQL schema from a Python module.
- [Development server](https://fastql.vachagan.dev/tooling/dev-server.md): Run a schema locally with the playground and schema endpoints.
- [SDL and introspection](https://fastql.vachagan.dev/tooling/schema-output.md): Inspect the compiled schema as SDL or standard introspection data.