examples/

Lift Framework Examples

This directory contains working examples demonstrating various features and patterns of the Lift framework.

🚀 Getting Started

Core Examples

• hello-world - Minimal Lambda function with type safety
• error-handling - Structured error handling patterns

🔐 Authentication & Security

• jwt-auth-demo - JWT authentication demonstration
• rate-limiting - Rate limiting middleware implementation

🔄 Real-time & Event-Driven

• websocket-demo - WebSocket support with connection management
• websocket-enhanced - Advanced WebSocket implementation
• event-adapters - Multiple AWS event source handlers (SQS, S3, EventBridge)
• sqs-large-payload - SQS payloads >256KB offloaded to S3 (pointer envelope + delete-on-success)
• multi-event-handler - Handling multiple event types
• eventbridge-wakeup - EventBridge scheduled events
• multiple-scheduled-events - Multiple scheduled Lambda triggers

🏢 Enterprise Applications

• multi-tenant-saas - Multi-tenant SaaS patterns
• enterprise-banking - Banking application with SOC2 compliance
• enterprise-healthcare - Healthcare with HIPAA compliance
• enterprise-ecommerce - E-commerce platform example

🏭 Production Patterns

• production-api - Production-ready API configuration
• multi-service-demo - Microservices with chaos engineering
• observability-demo - Comprehensive logging and monitoring
• health-monitoring - Health check implementation

🧪 Testing & Development

• mocking-demo - Testing with mocks
• cloudwatch-mocking-demo - CloudWatch metrics mocking
• streamer-quickstart - Quick start with streaming

🔧 Special Purpose

• test-scheduled-fix - Scheduled event fixes

Running Examples

Each example directory contains its own main.go file and often a README.md with specific instructions. To run an example:

cd examples/hello-world
go run main.go

For Lambda deployment:

GOOS=linux GOARCH=amd64 go build -o bootstrap main.go
zip function.zip bootstrap

Testing Examples

Some examples include test files. Run tests with:

go test -v

Contributing

When adding new examples:

1. Create a descriptive directory name
2. Include a README.md explaining the example
3. Keep examples focused on demonstrating specific features
4. Include tests where appropriate
5. Update this file to list your example