# Rank

> Deterministic configuration language and bootstrap compiler

Rank documentation for deterministic configuration programs, provider-backed workflows, the server runtime, and compiler tooling. Start with Intro, Getting Started, Concepts, and the Language section.

## Table of Contents

- [Introduction](https://rank-lang.com/docs/intro.md): Declarative, deterministic configuration language for generating typed structured outputs such as JSON and YAML.
- [Getting Started](https://rank-lang.com/docs/getting-started.md): Install the Rank compiler, write your first Rank program, and produce your first output in minutes.
- [Concepts](https://rank-lang.com/docs/concepts.md): Core Rank language concepts including declarative design, immutable bindings, graph evaluation, and determinism.
- [Bindings and functions](https://rank-lang.com/docs/language/bindings.md): Immutable bindings, first-class functions, and type-driven declarations in Rank programs.
- [Errors and diagnostics](https://rank-lang.com/docs/language/errors.md): Rank error categories, sensitive value redaction, and practical diagnostic workflows.
- [External inputs](https://rank-lang.com/docs/language/external-inputs.md): Read environment variables, files, and HTTP APIs with explicit typed schemas and dependency tracking.
- [Modules and imports](https://rank-lang.com/docs/language/imports.md): Module imports and namespace resolution across Rank projects, packages, and providers.
- [Mutations](https://rank-lang.com/docs/language/mutations.md): Provider-backed mutations with explicit fulfillment, commit lifecycle, and deterministic evaluation boundaries.
- [Output and manifests](https://rank-lang.com/docs/language/output.md): Emit single documents or multi-file manifests from Rank programs.
- [Standard library](https://rank-lang.com/docs/language/stdlib.md): Standard library reference for collections, strings, regex, time, parsing, and paths in Rank.
- [Values and types](https://rank-lang.com/docs/language/values-and-types.md): Rank value types, collections, type aliases, field annotations, and generic constraints.
- [Docker Compose](https://rank-lang.com/docs/examples/docker-compose.md): Generate Docker Compose configs from typed service definitions with environment-specific overrides.
- [Dotenv Config](https://rank-lang.com/docs/examples/dotenv-config.md): Read a project-local dotenv file with File::Read, Decode boundary parsing, and typed defaults.
- [DynamoDB Report](https://rank-lang.com/docs/examples/dynamodb-report.md): Read DynamoDB items through the AWS provider and emit a typed weekly sales report.
- [Env Inputs](https://rank-lang.com/docs/examples/env-inputs.md): Read typed environment variables with literal unions, sensitive schema annotations, boundary decoding, and environment-aware overrides.
- [Faker Dataset](https://rank-lang.com/docs/examples/faker-dataset.md): Generate deterministic datasets with the Faker provider using correlated person and location scopes.
- [Feature Flag Matrix](https://rank-lang.com/docs/examples/feature-flag-matrix.md): Generate per-plan feature flag bundles and environment-by-plan matrices from one typed model.
- [File-driven Config](https://rank-lang.com/docs/examples/file-driven-config.md): Load and reshape YAML config files at compile time into deployment manifests.
- [Functions and Lifting](https://rank-lang.com/docs/examples/functions-and-lifting.md): First-class functions, automatic lifting over lists and objects, and non-destructive overrides with with.
- [GitHub Actions](https://rank-lang.com/docs/examples/github-actions.md): Generate GitHub Actions workflows with version matrices and conditional steps.
- [GitLab CI](https://rank-lang.com/docs/examples/gitlab-ci.md): Generate GitLab CI pipelines with reusable job templates and conditional execution rules.
- [Hello Config](https://rank-lang.com/docs/examples/hello-config.md): Compact Rank program demonstrating type validation, constraints, and composition.
- [HTTP Fetch](https://rank-lang.com/docs/examples/http-fetch.md): Fetch external API data at compile time and transform it into validated artifacts.
- [HTTP Plus Files Bundle](https://rank-lang.com/docs/examples/http-plus-files-bundle.md): Combine local YAML files and HTTP fetches into bundled JSON and YAML output.
- [Examples](https://rank-lang.com/docs/examples/index.md): Gallery of runnable Rank examples organized by language features, platforms, and data sources.
- [Kubernetes App](https://rank-lang.com/docs/examples/kubernetes-app.md): Generate Kubernetes deployments, services, config maps, ingress, and autoscaling from one typed model.
- [LocalStack Bootstrap](https://rank-lang.com/docs/examples/localstack-bootstrap.md): Seed LocalStack DynamoDB and S3 resources with one Rank mutation plan.
- [Multi-env App](https://rank-lang.com/docs/examples/multi-env-app.md): Generate environment-specific app configs with shared base settings and targeted overrides.
- [Pipes and Collections](https://rank-lang.com/docs/examples/pipes-and-collections.md): Collection operations and the pipe operator for data transformation and aggregation.
- [Provider Comparison](https://rank-lang.com/docs/examples/provider-comparison.md): Normalize environment, file, HTTP, and S3 inputs into one shared output schema.
- [S3 Logs](https://rank-lang.com/docs/examples/s3-logs.md): Parse S3 nginx access logs through a Rank HTTP server using pattern-based extraction.
- [Secrets-Backed Config](https://rank-lang.com/docs/examples/secrets-backed-config.md): Merge application config from shared defaults, environment input, and AWS Secrets Manager secrets.
- [Serve — Docker](https://rank-lang.com/docs/examples/serve-docker.md): Package Rank HTTP applications into container images for Docker deployment.
- [Serve — Lambda Web Adapter](https://rank-lang.com/docs/examples/serve-lambda.md): Deploy Rank HTTP apps to AWS Lambda with Lambda Web Adapter and a custom runtime.
- [Service Catalog](https://rank-lang.com/docs/examples/service-catalog.md): Define services once and emit summaries, CI matrices, Compose files, and deployment metadata.
- [Static Site Deploy Plan](https://rank-lang.com/docs/examples/static-site-deploy-plan.md): Generate static site deployment plans, cache-control rules, and redirect configurations.
- [Tenant Config Generator](https://rank-lang.com/docs/examples/tenant-config-generator.md): Generate per-tenant runtime configs and a shared routing index from one tenant list.
- [Test Fixtures](https://rank-lang.com/docs/examples/test-fixtures.md): Generate deterministic test fixtures with the Faker provider and reproducible seeds.
- [Types and Generics](https://rank-lang.com/docs/examples/types-and-generics.md): Type aliases, constrained generics, utility types, and exhaustive pattern matching in Rank.
- [Manifest Reference](https://rank-lang.com/docs/manifest-reference.md): Complete reference for rank.toml project manifests, dependencies, providers, registries, and security settings.
- [CLI Reference](https://rank-lang.com/docs/cli.md): Rank CLI commands and flags for compiling, testing, checking, and serving Rank programs.
- [HTTP Server](https://rank-lang.com/docs/server.md): Build HTTP servers with Rank using typed route definitions, request handlers, and provider-backed logic.
- [Unit Testing](https://rank-lang.com/docs/testing.md): Unit testing for Rank programs with deterministic fixtures, expected output checks, and diagnostic assertions.
- [Debugging](https://rank-lang.com/docs/debugging.md): Debug Rank programs with compile-time checks, dependency graphs, evaluation traces, and focused diagnostics.
- [Editor Support](https://rank-lang.com/docs/editor-support.md): Use the Rank language server and editor support in VS Code, Neovim, Helix, Zed, and other LSP-capable editors.
- [Faker Provider](https://rank-lang.com/docs/faker-provider.md): Faker provider for deterministic test data generation with typed person, company, and location helpers.
- [AWS Provider](https://rank-lang.com/docs/aws-provider.md): First-party AWS provider for typed getters, mutations, and client helpers under the aws namespace.
- [Dependencies](https://rank-lang.com/docs/dependencies.md): Manage Rank dependencies from local paths, npm registries, and git repositories.
- [Provider authoring](https://rank-lang.com/docs/provider-authoring.md): Create and publish Rank providers that expose typed functions to Rank programs.
- [Project Structure](https://rank-lang.com/docs/project-structure.md): Repository structure, source-of-truth docs, packages, and test data in the Rank monorepo.
- [Spec And Plan](https://rank-lang.com/docs/spec-and-plan.md): Language specification, implementation plan, and source-of-truth planning documents for Rank.