docs(develop-with-ai): AWS Blocks steering-file recipe + modal icon fix#8608
Open
harsh62 wants to merge 1 commit into
Open
docs(develop-with-ai): AWS Blocks steering-file recipe + modal icon fix#8608harsh62 wants to merge 1 commit into
harsh62 wants to merge 1 commit into
Conversation
harsh62
added a commit
that referenced
this pull request
Jul 2, 2026
The AWS Blocks steering-file section now lives in #8608. Restore steering-files/index.mdx to its main version here so this PR is scoped to the Blocks docs only.
harsh62
added a commit
that referenced
this pull request
Jul 2, 2026
* docs(build-a-backend): add AWS Blocks integration section Add an "AWS Blocks" section under Build a Backend covering how to add AWS Blocks to an existing Amplify Gen 2 project, how the integration works, connecting a frontend, and task-based guides for adding an AI agent and using BasicAuth. Add a Blocks integration steering-file recipe for AI coding assistants. - New pages under src/pages/[platform]/build-a-backend/aws-blocks/ - Register pages in directory.mjs (top of Build a Backend, New badge) - Extend develop-with-ai/steering-files with an AWS Blocks section - Add Blocks terminology to cspell dictionary * docs(build-a-backend): fix Connect your frontend link in Blocks how-it-works Add the missing build-a-backend/ path segment so the Next steps link resolves instead of 404ing. * chore: update yarn.lock to v10 format for Yarn 4.17 CI's set_yarn_berry action runs 'yarn set version berry', which resolves to the latest Yarn (now 4.17.0) and rewrites the lockfile to __metadata version 10. The committed lockfile was version 9, so the immutable install step failed on every PR. Regenerate the lockfile and bump packageManager to match what CI resolves. * feat(modal): introduce AWS Blocks in the announcement modal Repurpose the site announcement modal from 'Introducing Amplify Gen 2' to 'Introducing AWS Blocks', since Gen 2 is now established and AWS Blocks is the new capability. Add two feature highlights, an internal link to the Blocks docs section, and an external link to AWS Blocks on AWS. Use a new dismissal key so the announcement re-shows. Remove the now-unused Gen 1 back-link, isGen1 prop, and orphaned useGen1Path helper. * docs(aws-blocks): correct verified API usage in Agent and AuthBasic guides Verified all code examples against the aws-blocks source repo: - add-an-agent: expose getChannel() on the backend API namespace. The frontend useChat subscribe() calls api.getChannel(), but it is not auto-generated and must be defined explicitly (matches the bb-agent README end-to-end example and test-apps/comprehensive). - use-basic-auth: setAuthState() does not throw; it returns an AuthState with errorName. Replace the try/catch + isBlocksError pattern with hasAuthError(next, ...), per the bb-auth-basic README rule of thumb. - get-started: list all four scaffolded npm scripts (sandbox, sandbox:delete, blocks:dev, blocks:generate-client). * fix(modal): add spacing between modal action label and icon The 'AWS Blocks on AWS' button's external-link icon overlapped its label because .modal-action had no inline-flex layout or gap. Add inline-flex + gap (matching .modal-heading) so text and trailing icons are spaced. * feat(modal): differentiate Blocks CTA labels and feature examples - Rename actions so they read distinctly: primary "Explore Blocks with Amplify" (left, into the Amplify docs) and secondary "AWS Blocks documentation" (right, external). Previously both said "AWS Blocks". - Swap feature examples that overlapped Amplify's own categories (AI agents, auth, storage) for differentiated Blocks capabilities: PostgreSQL databases, realtime messaging, metrics, logging. * feat(modal): rename secondary CTA to "Get Started with Blocks" Keeps the external-link icon to signal it opens a new page (the AWS Blocks docs). Pairs with the primary "Explore Blocks with Amplify" action. * docs(build-a-backend): move steering-file recipe to a separate PR The AWS Blocks steering-file section now lives in #8608. Restore steering-files/index.mdx to its main version here so this PR is scoped to the Blocks docs only. * docs(aws-blocks): address PR review feedback on Agent guide Verified against current aws-blocks/main (local clone was 31 commits stale, which is how these were missed): - useChat adapter now compiles: backend returns { conversationId } and { messages } and sendMessage accepts channelId, matching the UseChatOptions interface and the bb-agent README end-to-end example. - Replace deprecated BedrockModels.DEFAULT with BALANCED; note model is optional (defaults to BALANCED). - Move Realtime to a Real-time & async category (matches the Blocks reference), leaving EmailClient under Communication. - Reword the useChat factory callout ("Despite the name..."). * docs(aws-blocks): re-verify examples against latest aws-blocks main Pulled aws-blocks to HEAD e8f3854 and re-verified all examples: - Agent sendMessage now passes userId to agent.stream(); without it the Agent throws PersistenceRequired at runtime (bb-agent agent.ts:407). - Revert Realtime to the Communication category and restore Compute & background (AsyncJob/CronJob) to match the aws-blocks root README grouping (the authoritative in-repo source). - Drop blocks:dev from the scaffolded-scripts list: the CLI points it at aws-blocks/scripts/server.ts, which the amplify template does not ship, so it is non-functional for Amplify projects.
…l icons
Adds an "AWS Blocks integration" section to the steering-files page with
a per-tool recipe (Claude Code, Cursor, Kiro) so AI coding assistants
follow the Blocks integration patterns. All claims verified against the
aws-blocks source (create-blocks-app scaffolds AGENTS.md; backend in
aws-blocks/index.ts with CognitoVerifier + requireAuth; blocks:generate-client;
import { api } from aws-blocks; npm run sandbox).
Also folds in the modal icon fix from #8609: replace the puzzle emoji
with IconStar and size both feature-point icons consistently.
Rebuilt on latest main so the aws-blocks internal links (merged in #8606)
resolve, clearing the earlier CheckPRLinks failure.
harsh62
force-pushed
the
docs/aws-blocks-steering-file
branch
from
0f5b59b to
30f4e08
Compare
harsh62
changed the title
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds an "AWS Blocks integration" section to the steering-files page with a per-tool recipe (Claude Code / CLAUDE.md, Cursor / .cursor/rules, Kiro / .kiro/steering) so AI coding assistants follow the Blocks integration patterns in an Amplify Gen 2 project.
Also folds in the announcement-modal icon fix (previously #8609, now closed): replaces the puzzle emoji with IconStar and sizes both feature-point icons consistently.
Notes