Repo brief: shuttle-hq/shuttle

Generated by RepoPilot · document generated 2026-09-13 · concise human review Evidence snapshot · analyzed 2026-09-13T08:41:25.883Z · commit a95d41386faa

Verdict

Mixed — Slowing — last commit 4mo ago

• Last commit 4mo ago
• 7 active contributors
• Apache-2.0 licensed
• Tests present

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests

What it is

Shuttle is a Rust-native backend framework that eliminates infrastructure boilerplate by provisioning cloud resources (databases, caches, queues) through single lines of code in your application, then deploying the entire project without writing YAML or Dockerfile manually. It transforms multi-step deployment workflows into a cargo shuttle deploy command, targeting developers who want production infrastructure as seamlessly as adding a crate dependency. Monorepo with 9 member crates: cargo-shuttle/ is the CLI binary that users invoke, runtime/ provides the async runtime and macros, codegen/ generates boilerplate via proc-macros, builder/ renders Dockerfiles from Jinja2 templates,…

Start here

• cargo-shuttle/src/bin/cargo-shuttle.rs: Entry point of the CLI tool that users invoke; orchestrates…
• runtime/src/lib.rs: Core async runtime and macro definitions that allow developers to declare resources with #[shuttle::main]
• builder/templates/rust.Dockerfile.jinja2: Template for generating Dockerfiles during build; critical for…
• codegen/src/: Proc-macro expansion for the #[shuttle::*] attribute macros that developers write
• api-client/src/lib.rs: HTTP client for communicating with shuttle.rs backend; handles authentication and deployment API calls

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

git clone https://github.com/shuttle-hq/shuttle.git
cd shuttle
cargo build --workspace
cargo test --workspace
# For CLI use:
cargo install --path cargo-shuttle
cargo shuttle new my-project
cd my-project
cargo shuttle run

Daily commands:

Development: cargo build && cargo run -p cargo-shuttle -- shuttle new my-app starts the local workflow. For testing the full stack: cargo test --workspace runs the integration suite. The actual deployment requires c…

…shortened for this brief.

Key cautions & unknowns

• Slowing — last commit 4mo ago
• Concentrated ownership — top contributor handles 78% of recent commits
• Authentication: cargo-shuttle commands require valid API credentials (typically stored in ~/.shuttle after login); local cargo shuttle run may fail silently if API tokens are expired. Docker requirement:…
• Published-advisory coverage was unavailable for the captured dependencies.
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.