rust-microservice-template 🦀

WIP - extracted from production, still figuring out what else to add

My go-to patterns for Rust microservices on AWS Lambda. Got tired of copying the same boilerplate between services so I extracted what actually works.

What's in here 🦀

• Cargo workspace - monorepo structure, common crate for shared stuff
• lambda_http - lighter than Axum/Actix for Lambda
• DynamoDB singleton - OnceCell pattern, no client recreation per request
• Dual-mode auth - dev tokens for local, Cognito JWT for prod
• Cursor pagination - base64 encoded LastEvaluatedKey, works out of the box

Getting started 🦀

cargo check
cargo test
# or build for lambda
cargo lambda build --release

Structure 🦀

├── common/           # shared utilities
│   └── src/
│       ├── auth.rs       # dual-mode JWT
│       ├── db.rs         # dynamodb singleton
│       ├── cors.rs
│       ├── health.rs
│       └── pagination.rs
└── services/
    └── example/      # copy this for new services

Dev auth 🦀

curl -H "Authorization: Bearer dev:matt@example.com:user" \
  http://localhost:9000/items

Format: Bearer dev:<email>:<role>

Adding a service 🦀

1. Copy services/example/
2. Add to workspace in root Cargo.toml
3. Implement your handlers

---

Pairs well with solidjs-fe-template for admin portals.