aws avatar

Aws Blocks

This covers AWS Blocks, an infrastructure-from-code framework that bundles CDK, SDK, and local mocks into a single API. You define your entire backend in one aws-blocks directory, and the frontend gets fully typed imports without code generation. It ships with 18+ building blocks for storage, auth, realtime, background jobs, and more, all of which run locally without AWS credentials. The skill guides you through scaffolding projects, picking the right building blocks like KVStore or AuthCognito, and deploying with least-privilege credentials. One thing to note: API methods are unauthenticated by default, so you need to explicitly call requireAuth on anything that shouldn't be public. Good fit if you want fast local development with a clear path to production AWS infrastructure.

skills.sh installs
5.9K
GitHub stars
3.4K
last updated
Aug 21, 2026

Install

$ npx -y skills add aws/agent-toolkit-for-aws --skill aws-blocks --agent claude-code

Installs into .claude/skills of the current project.

Files

AWS Blocks Application Development

Package naming: All packages are published under the @aws-blocks scope (e.g., @aws-blocks/core, @aws-blocks/blocks, @aws-blocks/bb-kv-store).

Overview

AWS Blocks is an Infrastructure-from-Code framework where Building Blocks bundle CDK, SDK, and local mocks into a single API. It provides 18+ Building Blocks covering storage, authentication, real-time communication, background jobs, file management, AI/search, email, and observability — all working locally without AWS credentials.

Key characteristics:

  • One aws-blocks/ directory defines the entire backend
  • Frontend imports are fully typed — no client generation needed
  • All Building Blocks work locally without AWS (mocks persist to .bb-data/)
  • Deploy ephemeral, individual testing environments with npm run sandbox and long-lived environments with npm run deploy using least-privilege credentials

Scaffolding a New Project

npx @aws-blocks/create-blocks-app my-app
cd my-app

To add AWS Blocks to an existing project:

npx @aws-blocks/create-blocks-app .

Sponsors

Details

Repository
github.com/aws/agent-toolkit-for-aws
Categories
Backend & APIs, AI & Agent Building, Release Management, Cloud & Infrastructure, Databases
First seen
Jul 14, 2026

More from aws/agent-toolkit-for-aws

All 56
1okx avatarokx-dex-wsokx/onchainos-skillsUse this skill when the user mentions 'onchainos ws', 'ws start', 'ws poll', 'ws stop', 'ws channels', 'ws session', 'ws channel-info', 'idle-timeout', 'idle ti5.8Kskills.sh installs
2qianwen-ai avatarqianwen-usageqianwen-ai/qianwen-ai[QianWen] Manage account auth and query usage/billing. Use for: login, logout, check usage, view billing, free tier quota, Token Plan status, pay-as-you-go cost5.8Kskills.sh installs
3affaan-m avatardjango-tddaffaan-m/eccDjango testing strategies with pytest-django, TDD methodology, factory_boy, mocking, coverage, and testing Django REST Framework APIs.5.8Kskills.sh installs
4pexoai avatarvideoagent-image-studiopexoai/pexo-skillsTired of juggling 8 API keys? This skill gives you one-command access to Midjourney, Flux, Ideogram, and more, with zero setup. Use when you want to generate an5.6Kskills.sh installs
5forcedotcom avatarintegration-connectivity-generateforcedotcom/sf-skillsSalesforce integration architecture and runtime plumbing with 120-point scoring. Use this skill to set up Named Credentials, External Credentials, External Serv5.5Kskills.sh installs
6affaan-m avatarnutrient-document-processingaffaan-m/eccProcess, convert, OCR, extract, redact, sign, and fill documents using the Nutrient DWS API. Works with PDFs, DOCX, XLSX, PPTX, HTML, and images.5.4Kskills.sh installs