AWS Blocks | Build local full-stack apps in seconds, deploy to AWS when ready

Skip to main content

AWS Blocks

Overview

Build applications locally in seconds, deploy to AWS when ready

Ship applications on AWS with confidence. AWS Blocks gives you a functional local development environment with database, authentication, realtime, and more. No AWS account required until you are ready to ship.

Get Started

View on GitHub

Overview

AWS Blocks is an open source TypeScript framework that lets you compose backend capabilities from pre-built modules that generate infrastructure from code, letting you focus on business logic instead of infrastructure boilerplate. Run npm run dev and get a working application on your local machine, then deploy the same code to your AWS account with zero changes.

Benefits

Start building in seconds, not hours

Run npm run dev and get a fully functional local environment with Postgres, authentication, realtime, file storage, and background jobs. No AWS account, no infrastructure configuration, no waiting. When you deploy, infrastructure generates from the same application code you wrote locally. Your database queries, auth checks, and file operations do not change between environments.

End-to-end type safety without code generation

Define your data schema once and your frontend types update automatically. No codegen step for TypeScript apps, no OpenAPI spec to maintain, no runtime type mismatches. TypeScript propagates types from your database layer through your API to your UI components.

Built for agentic dev loops

Steering files ship directly in the npm package, guiding AI coding agents to produce correct architecture from the start. No plugin installation, no custom configuration. Agents have less freedom to misconfigure, and more freedom to test functionality end to end.

No ceiling on what you can build

Every Block is backed by production AWS services. When you need deeper customization, drop one layer into AWS CDK and configure the underlying resources directly. You are never locked into an abstraction that cannot express what you need, and you never need to learn AWS services in depth unless you choose to.

Compose with what you already use

AWS Blocks integrates with your existing resources. Connect to external Postgres services, APIs and auth providers.

Use Cases

Building blocks for your app

AI agents and chatbots

Event-driven workflows

Building blocks for your app

Define your API, database, authentication, and file storage in TypeScript. The same backend serves your web frontend through direct imports and mobile clients through generated Swift, Kotlin, and Dart bindings. Deploy once, serve every platform.

AI agents and chatbots

Build agents and conversational AI applications with the Agent Block (tool calling, conversation persistence, human-in-the-loop approval) and connect it to your data with the KnowledgeBase Block for retrieval-augmented generation. Test against any OpenAI-compatible endpoint (like Ollama on your local machine), then deploy to Bedrock in production.

Event-driven workflows

Compose background jobs, scheduled tasks, real-time notifications, and email into workflows that react to application events. AsyncJob processes uploads, CronJob generates nightly reports, Realtime pushes updates to connected clients, and EmailClient sends confirmations. Each runs locally for testing and deploys to managed compute in production.

Features

Building Blocks for your app

Each Block in AWS Blocks bundles backend logic, a type-safe API, a local testing configuration and steering files into a single import. You get 20+ Blocks covering the most common full-stack needs, each designed to work together.

Database provides a type-safe Postgres interface that runs locally via PGlite and deploys to managed Postgres on AWS.

Auth supports multiple authentication types including email/password, social login, enterprise SSO, and compatibility with existing auth providers.

Realtime delivers pub/sub with a local server for development and managed WebSockets in production.

FileBucket handles uploads and downloads with local filesystem storage that mirrors cloud behavior.

AsyncJob and CronJob run background work and scheduled tasks with local execution for testing and managed compute in production.

AI and observability

Build intelligent applications and monitor them with integrated observability, all using the same Block pattern.

Agent provides AI agent orchestration with tool calling and conversation persistence. Test locally against Ollama or any OpenAI-compatible endpoint before connecting to managed AI services in production.

KnowledgeBase connects your data sources to semantic retrieval with a single Block.

EmailClient sends email with local capture for development testing.

Logger, Metrics, and Tracer provide structured observability that writes to console locally and managed monitoring in production.

Dashboard generates observability dashboards from...