Coolaid Stand Demo

The Coolaid Stand is a branded e-commerce storefront for a fictional AGI-themed drink company. The point: the customer owns the entire UI. The SDK handles the chat runtime, typed messages, tools, auth, transport, and diagnostics underneath.

This demo shows what a production integration looks like when you go beyond the default components and build something with its own visual identity.

Run it

From the repo root:

pnpm install --frozen-lockfile
pnpm build:packages          # builds the SDK from source
pnpm dev:coolaid             # starts the storefront at http://localhost:3001

Mock mode requires no credentials. It uses gecx-chat, gecx-chat/testing, custom Coolaid Stand scenarios, custom client tools, and A2UI rendering via gecx-chat/a2ui/react.

What to try

Walk through the demo in order to see each SDK feature build on the last.

1. Land on the storefront

You see a real product page with AGI-themed drinks. The chat is not a floating widget -- it is a branded "Stand Concierge" panel integrated into the store layout.

2. Open the Stand Concierge

The concierge opens with recommendation chips. These are suggestion chips powered by the SDK, styled to match the store brand.

3. Ask for recommendations

Try asking for a focus flavor. The SDK streams a response with product rich-content parts -- images, descriptions, and pricing rendered in the store's own card components.

4. Ask for something specific

Ask for something refreshing but not too sweet. The SDK returns an A2UI-generated flavor tuner with sliders and an action button. This is generative UI: the agent decided the best response was an interactive widget, not just text.

5. Ask to add a case to cart

Tell the concierge to add a case to your cart. A client tool approval prompt appears in the custom UI. The SDK requires user consent before running tools with side effects.

6. See the cart update

Approve the tool call. The cart updates and the assistant confirms the action. The entire flow -- streaming, rich content, generative UI, tool approval, and state sync -- ran through the SDK.

SDK features demonstrated

• Custom-branded UI built on the headless SDK (no default widget)
• Streaming responses with typed message parts
• Rich-content product cards
• A2UI v0.9 generative UI (flavor tuner)
• Client tool approval for cart mutations
• Suggestion chips
• Mock transport with custom scenarios

GECX live bridge (optional)

The app includes an experimental GECX/UJET live bridge for connecting to real Google infrastructure. See the app README for credentials setup and the POST /api/gecx/auth server route details.

What's next

• Applied AI Retail -- an end-to-end retail journey that lives entirely inside the chat (browse → cart → checkout → returns).
• Showcase App -- explore every SDK feature route by route.
• SDK Quickstart -- start building your own integration.
• App README -- verification commands and GECX credentials.