templates.toml

# Shuttle Template Definitions
#
# The schema is defined in `shuttle_common::templates`.
# Use `rust-script _scripts/check-templates.rs` to validate this list.
version = 1

# mapping of tag name -> image url
[logos]
actix-web = "https://avatars.githubusercontent.com/u/32776943?v=4"
axum = "https://avatars.githubusercontent.com/u/20248544?v=4"
rocket = "https://avatars.githubusercontent.com/u/106361765?v=4"
bevy = "https://avatars.githubusercontent.com/u/60047606?v=4"
loco = "https://avatars.githubusercontent.com/u/151030972?v=4"
poem = "https://avatars.githubusercontent.com/u/88869778?v=4"
poise = "https://avatars.githubusercontent.com/u/32077193?v=4"
rama = "https://avatars.githubusercontent.com/u/87996217?v=4"
serenity = "https://avatars.githubusercontent.com/u/32077193?v=4"
salvo = "https://avatars.githubusercontent.com/u/77909452?v=4"
tower = "https://avatars.githubusercontent.com/u/26263939?v=4"
postgres = "https://avatars.githubusercontent.com/u/177543?v=4"
clerk = "https://avatars.githubusercontent.com/u/49538330?v=4"
htmx = "https://raw.githubusercontent.com/bigskysoftware/htmx/8e26d12c33caf7dc99c49d4918e7b8abd8028f98/www/static/img/htmx_logo.2.png"
qdrant = "https://avatars.githubusercontent.com/u/73504361?v=4"
nextjs = "https://assets.vercel.com/image/upload/v1662130559/nextjs/Icon_light_background.png"
opendal = "https://avatars.githubusercontent.com/u/47359?v=4"
openai = "https://avatars.githubusercontent.com/u/14957082?v=4"
# fallback
shuttle = "https://avatars.githubusercontent.com/u/54710151?v=4"

## OFFICIAL STARTERS ##

[starters.actix-web-hello-world]
title = "Actix Web"
description = "Powerful and fast web framework"
path = "actix-web/hello-world"
use_cases = ["Web app"]
tags = ["actix-web"]
template = "actix-web"
has_template_repo = true

[starters.axum-hello-world]
title = "Axum"
description = "Modular web framework from the Tokio ecosystem"
path = "axum/hello-world"
use_cases = ["Web app"]
tags = ["axum"]
template = "axum"
has_template_repo = true

[starters.bevy-hello-world]
title = "Bevy"
description = "Data driven game engine that compiles to WASM"
path = "bevy/hello-world"
use_cases = ["Web app", "Game"]
tags = ["bevy", "axum"]
has_template_repo = true

[starters.loco-hello-world]
title = "Loco"
description = "Batteries included web framework based on Axum"
path = "loco/hello-world"
use_cases = ["Web app"]
tags = ["loco"]
template = "loco"
has_template_repo = true

[starters.poem-hello-world]
title = "Poem"
description = "Full-featured and easy-to-use web framework"
path = "poem/hello-world"
use_cases = ["Web app"]
tags = ["poem"]
template = "poem"

[starters.poise-hello-world]
title = "Poise"
description = "Discord Bot framework with good slash command support"
path = "poise/hello-world"
use_cases = ["Discord bot"]
tags = ["poise", "serenity"]
template = "poise"

[starters.rama-hello-world]
title = "Rama"
description = "Modular service framework to move and transform network packets"
path = "rama/hello-world"
use_cases = ["Web app"]
tags = ["rama"]
template = "rama"

[starters.rocket-hello-world]
title = "Rocket"
description = "Simple and easy-to-use web framework"
path = "rocket/hello-world"
use_cases = ["Web app"]
tags = ["rocket"]
template = "rocket"
has_template_repo = true

[starters.salvo-hello-world]
title = "Salvo"
description = "Full-featured and easy-to-use web framework"
path = "salvo/hello-world"
use_cases = ["Web app"]
tags = ["salvo"]
template = "salvo"

[starters.serenity-hello-world]
title = "Serenity"
description = "Discord Bot framework"
path = "serenity/hello-world"
use_cases = ["Discord bot"]
tags = ["serenity"]
template = "serenity"

[starters.tower-hello-world]
title = "Tower"
description = "Modular service library"
path = "tower/hello-world"
use_cases = ["Web app"]
tags = ["tower"]
template = "tower"

[starters.warp-hello-world]
title = "Warp"
description = "Web framework"
path = "warp/hello-world"
use_cases = ["Web app"]
tags = ["warp"]
template = "warp"

[starters.no-framework]
title = "No framework"
description = "An empty implementation of the Shuttle Service trait"
path = "custom-service/none"
use_cases = []
tags = ["diy"]
template = "none"


## OFFICIAL TEMPLATES ##

[templates.actix-web-postgres]
title = "Postgres"
description = "Todo list with a Postgres database"
path = "actix-web/postgres"
use_cases = ["Web app", "Storage"]
tags = ["actix-web", "postgres", "database"]

[templates.actix-web-clerk-react]
title = "Clerk authentication"
description = "Fullstack Rust+React with auth provider logic"
path = "actix-web/clerk"
use_cases = ["Web app", "Authentication"]
tags = ["clerk", "actix-web", "react", "typescript", "tailwind"]

[templates.actix-cookie-authentication]
title = "Cookie Authentication"
description = "Use JWT to authenticate API endpoints"
path = "actix-web/cookie-authentication"
use_cases = ["Web app", "Authentication"]
tags = ["actix-web", "jwt"]

[templates.actix-websocket-actorless]
title = "Websockets Actorless"
description = "Health monitoring service using websockets"
path = "actix-web/websocket-actorless"
use_cases = ["Web app", "Monitoring"]
tags = ["actix-web", "websocket"]

[templates.actix-static-files]
title = "File server"
description = "Hello World page that serves static HTML and JS files"
path = "actix-web/static-files"
use_cases = ["Web app"]
tags = ["actix-web"]

[templates.axum-htmx-crud]
title = "HTMX"
description = "Simple CRUD app using HTMX and Askama"
path = "axum/htmx-crud"
use_cases = ["Web app", "Storage"]
tags = ["htmx", "axum", "database", "postgres"]

[templates.axum-jwt-authentication]
title = "JWT authentication"
description = "Use JWT to authenticate API endpoints"
path = "axum/jwt-authentication"
use_cases = ["Web app", "Authentication"]
tags = ["axum", "jwt"]

[templates.axum-oauth2]
title = "OAuth authentication"
description = "Use Google OAuth to authenticate API endpoints"
path = "axum/oauth2"
use_cases = ["Web app", "Authentication"]
tags = ["axum", "oauth"]

[templates.axum-ai-assisted]
title = "AI Assisted"
description = "AI-assisted development template"
path = "axum/ai-assisted"
use_cases = ["Web app", "AI"]
tags = ["axum", "ai"]

[templates.axum-openai]
title = "OpenAI ChatGPT chat"
description = "Connect your app to OpenAI ChatGPT"
path = "axum/openai"
use_cases = ["Web app", "AI"]
tags = ["openai", "axum"]

[templates.axum-postgres]
title = "Postgres"
description = "Todo list with a Postgres database"
path = "axum/postgres"
use_cases = ["Web app", "Storage"]
tags = ["axum", "postgres", "database"]

[templates.axum-qdrant]
title = "Qdrant"
description = "Connecting to Qdrant cloud with shuttle-qdrant"
path = "axum/qdrant"
use_cases = ["Web app", "Storage", "AI"]
tags = ["qdrant", "axum", "database"]

[templates.axum-static-files]
title = "File server"
description = "Hello World static file server with tower-http"
path = "axum/static-files"
use_cases = ["Web app"]
tags = ["axum"]

[templates.axum-todo-list]
title = "Todo list"
description = "CRUD API, Postgres database, and static file server combined into a classic Todo list app"
path = "axum/todo-list"
use_cases = ["Web app", "Storage"]
tags = ["axum", "postgres", "database"]
has_template_repo = true

[templates.axum-todo-app]
title = "Todo app"
description = "CRUD Todo application with Postgres database and frontend"
path = "axum/todo-app"
use_cases = ["Web app", "Storage"]
tags = ["axum", "postgres", "database"]

[templates.axum-polars-otel-shuttle]
title = "Polars ETL with OpenTelemetry"
description = "ETL pipeline with Polars and Open Telemetry monitoring"
path = "axum/polars-otel-shuttle"
use_cases = ["ETL", "Data Engineering", "Observability"]
tags = ["axum", "polars", "opentelemetry", "etl"]

[templates.axum-turso]
title = "Turso"
description = "Connect to a Turso DB with shuttle-turso"
path = "axum/turso"
use_cases = ["Web app", "Storage"]
tags = ["turso", "axum", "database", "libsql", "sqlite"]

[templates.axum-code-snippet-sharing-app]
title = "Code Snippet Sharing"
description = "Share and manage code snippets with expiration and view tracking"
path = "axum/code-snippet-sharing-app"
use_cases = ["Web app", "Storage"]
tags = ["axum", "postgres", "database"]

[templates.axum-websocket]
title = "Websockets"
description = "Health monitoring service using websockets"
path = "axum/websocket"
use_cases = ["Web app", "Monitoring"]
tags = ["axum", "websocket"]
has_template_repo = true

[templates.axum-next-fullstack-saas]
title = "Fullstack SaaS"
description = "Opinionated fullstack web app with pre-made routes and assets"
path = "fullstack-templates/saas"
use_cases = ["Web app", "Authentication", "Storage", "Monetization"]
tags = ["nextjs", "axum", "database", "postgres", "typescript", "tailwind"]
has_template_repo = true

[templates.rama-hello-world-tcp]
title = "Rama TCP"
description = "HTTP Hello world with Rama using raw TCP"
path = "rama/hello-world-tcp"
use_cases = ["Web app"]
tags = ["rama"]

[templates.rama-static-files]
title = "File server"
description = "Hello World static file server with Rama"
path = "rama/static-files"
use_cases = ["Web app"]
tags = ["rama"]

[templates.rocket-dyn-templates]
title = "Handlebars dynamic templates"
description = "HTML templating with Handlebars"
path = "rocket/dyn-templates"
use_cases = ["Web app"]
tags = ["rocket", "handlebars"]

[templates.rocket-jwt-authentication]
title = "JWT authentication"
description = "Use JWT to authenticate API endpoints"
path = "rocket/jwt-authentication"
use_cases = ["Web app", "Authentication"]
tags = ["rocket", "jwt"]

[templates.rocket-opendal-memory]
title = "OpenDAL in-memory store"
description = "A key-value store using OpenDAL"
path = "rocket/opendal-memory"
use_cases = ["Web app", "Storage"]
tags = ["opendal", "rocket"]

[templates.rocket-postgres]
title = "Postgres"
description = "Todo list with a Postgres database"
path = "rocket/postgres"
use_cases = ["Web app", "Storage"]
tags = ["rocket", "postgres", "database"]

[templates.rocket-static-files]
title = "File server"
description = "Hello World page that serves static HTML files"
path = "rocket/static-files"
use_cases = ["Web app"]
tags = ["rocket"]

[templates.rocket-url-shortener]
title = "URL shortener"
description = "Save long URLs behind a short one, with OpenDAL/Postgres storage"
path = "rocket/url-shortener"
use_cases = ["Web app", "Storage"]
tags = ["rocket", "database", "opendal", "postgres"]

[templates.salvo-image-rescaler]
title = "Image Rescaler"
description = "Use the image library to rescale the Shuttle logo"
path = "salvo/image-rescaler"
use_cases = ["Web app", "Image processing"]
tags = ["salvo", "image"]
has_template_repo = true

[templates.serenity-postgres]
title = "Postgres"
description = "Todo list Discord bot with a Postgres database"
path = "serenity/postgres"
use_cases = ["Discord bot", "Storage"]
tags = ["serenity", "database", "postgres"]

[templates.serenity-weather-forecast]
title = "Weather Bot"
description = "Weather forecast Discord bot using the Accuweather API"
path = "serenity/weather-forecast"
use_cases = ["Discord bot"]
tags = ["serenity"]

[templates.shuttle-cron]
title = "Shuttle custom Cron service"
description = "Schedule tasks on a cron schedule with apalis"
path = "shuttle-cron"
use_cases = ["Cron jobs", "Storage"]
tags = ["axum", "apalis", "database", "postgres"]

[templates.custom-tracing-subscriber]
title = "Custom Tracing Subscriber"
description = "How to use a custom tracing-subscriber on Shuttle"
path = "tracing/custom-tracing-subscriber"
use_cases = ["Web app", "Logging"]
tags = ["actix-web", "tracing"]

[templates.mcp-sse]
title = "SSE MCP Server"
description = "Model Context Protocol server with Server-Sent Events transport"
path = "mcp/mcp-sse"
use_cases = ["Web app", "MCP"]
tags = ["axum", "mcp", "sse"]
has_template_repo = true

[templates.mcp-sse-oauth]
title = "SSE MCP Server with OAuth"
description = "MCP server with SSE transport and OAuth"
path = "mcp/mcp-sse-oauth"
use_cases = ["MCP", "AI", "AI Agents"]
tags = ["axum", "mcp", "sse", "oauth"]

[templates.mcp-http-stream]
title = "Streamable HTTP MCP Server"
description = "Model Context Protocol server with HTTP streaming transport"
path = "mcp/http-stream-mcp"
use_cases = ["MCP", "AI", "AI Agents"]
tags = ["axum", "mcp", "http-stream"]

## EXAMPLES ##

[examples.metadata]
title = "Shuttle Metadata"
description = "Basic usage of Shuttle Metadata"
path = "axum/metadata"
use_cases = []
tags = ["axum"]

[examples.secrets]
title = "Shuttle Secrets"
description = "Basic usage of Shuttle Secrets"
path = "rocket/secrets"
use_cases = ["Web app"]
tags = ["rocket"]

[examples.workspace]
title = "Workspace"
description = "How to use a Shuttle app in a Cargo workspace"
path = "rocket/workspace"
use_cases = []
tags = []

[examples.custom-resource-pdo]
title = "Custom Resource"
description = "A custom PDO resource for the Shuttle main macro"
path = "custom-resource/pdo"
use_cases = []
tags = ["diy"]

[examples.feature-flags]
title = "Shuttle feature flag"
description = "How to use cargo feature flags on Shuttle"
path = "other/feature-flags"
use_cases = []
tags = ["diy", "axum"]

[examples.standalone-binary]
title = "Standalone binary"
description = "How to run an app both with Shuttle and standalone"
path = "other/standalone-binary"
use_cases = []
tags = ["diy", "axum"]

## TUTORIALS ##

[tutorials]

## COMMUNITY TEMPLATES ##

# --- HOW TO ADD TO THE LIST ---
# 1. Your example should be in a public repository.
# 2. If it has a license, it should allow users to copy and modify the code.
# 3. Follow the pattern and add it to the list below

[community_templates.actix-github-oauth]
title = "GitHub Login (OAuth)"
description = "Sample app demonstrating GitHub OAuth login using Actix Web"
use_cases = ["Web app", "Authentication"]
tags = ["actix-web", "oauth"]
author = "robjtede"
repo = "https://github.com/robjtede/actix-examples-oauth-github"

[community_templates.fullstack-rust-axum-yew]
title = "Fullstack Rust"
description = "A template for fullstack Rust projects with Yew"
use_cases = ["Web app"]
tags = ["axum", "yew"]
author = "TylerBloom"
repo = "https://github.com/TylerBloom/shuttle-fullstack-rust-example"

[community_templates.axum-web-app-yew]
title = "Web app with Yew"
description = "A template for a web app using the Yew framework"
use_cases = ["Web app"]
tags = ["axum", "yew"]
author = "sentinel1909"
repo = "https://github.com/sentinel1909/shuttle-template-yew"

[community_templates.actix-web-api]
title = "Web API with Actix Web"
description = "A template for starting an API with Actix Web"
use_cases = ["Web app"]
tags = ["actix-web"]
author = "sentinel1909"
repo = "https://github.com/sentinel1909/shuttle-template-actix"

[community_templates.rocket-yew-sled]
title = "Web API with Rocket and Sled"
description = "A Full Stack CRUD template for starting an API with Rocket, Sled, and Yew"
use_cases = ["Web app"]
tags = ["rocket", "yew"]
author = "wiseaidev"
repo = "https://github.com/wiseaidev/rocket-yew-starter-pack"