aws-blocks

Builds full-stack applications with AWS Blocks Infrastructure-from-Code Building Blocks.

Updated Jul 1, 2026
One-click install
npx skills add https://github.com/sakicodes/BuildFestHackathon26 --skill aws-blocks-sakicodes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aws-blocks
Source: https://github.com/sakicodes/BuildFestHackathon26/tree/main/.agents/skills/aws-blocks
Command: npx skills add https://github.com/sakicodes/BuildFestHackathon26 --skill aws-blocks-sakicodes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Building full-stack AWS applications normally requires wiring together CDK constructs, SDK calls, and local mocks separately. This Skill guides you through AWS Blocks, an Infrastructure-from-Code framework where each Building Block bundles CDK, SDK, and local mocks into one typed API that works locally without AWS credentials. ## Core Features & Use Cases - Project Scaffolding: Create new apps or add AWS Blocks to existing projects (including Amplify Gen 2) with npx @aws-blocks/create-blocks-app, choosing from templates like default, react, nextjs, demo, and auth-cognito. - Building Block Selection: Get guidance on 18+ Building Blocks covering storage (KVStore, DistributedTable, Database), auth (AuthBasic, AuthCognito), realtime, async jobs, file storage, AI/search, email, and observability. - Security-First Patterns: Apply validated rules such as auth.requireAuth(context) on non-public methods, secret AppSettings, least-privilege IAM, and CORS configuration. - Use Case: Scaffold a todo app with the demo template, add auth-protected CRUD backed by DistributedTable with Zod schemas, test everything locally with mocks persisted to .bb-data/, then deploy with npm run deploy. ## Quick Start Scaffold a new AWS Blocks app with the demo template and ask the AI to add an auth-protected API method backed by a KVStore Building Block.

Frequently Asked Questions about aws-blocks

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a new AWS Blocks application?

Run npx @aws-blocks/create-blocks-app my-app to scaffold a new project. You can pick a template with --template, choosing from default, bare, react, backend, demo, auth-cognito, or nextjs.

How do I add AWS Blocks to an existing project?

Run npx @aws-blocks/create-blocks-app . inside your project root. The CLI detects the existing project and adds an aws-blocks/ workspace, and it automatically integrates with Amplify Gen 2 when it finds amplify/backend.ts.

Does AWS Blocks work locally without AWS credentials?

Yes, all Building Blocks run locally without AWS credentials. Mocks persist data to a .bb-data/ directory, so you can develop and test storage, auth, and realtime features entirely offline.

Which AWS Blocks Building Block should I use for data storage?

Use KVStore for simple key-value data, DistributedTable for indexed DynamoDB-style data with Zod schemas, or Database for relational needs. Read each block's package README under node_modules/@aws-blocks for the authoritative API reference.

Why are my AWS Blocks API methods accessible without authentication?

ApiNamespace methods are unauthenticated by default. Add await auth.requireAuth(context) at the start of every method that should not be public, and attach schemas to validate user-supplied data.

How do I deploy an AWS Blocks app to AWS?

Use npm run sandbox for ephemeral individual testing environments and npm run deploy for long-lived environments. Both use least-privilege credentials, and each Building Block grants IAM scoped only to its own resources.