Buzzy Project Guide

Plan, build, test, release, and maintain Buzzy apps.

Use this guide when you are planning a Buzzy project beyond a quick experiment. It brings together the same lifecycle covered across Getting Started, Building Blocks, Builder MCP, Figma, Tests, Security Review, and Deployment.

Choose the Right Starting Point

Starting point	Use when	Primary guide
Prompt / Buzzy AI	You want a fast first version from an idea.	Buzzy AI
Figma	Design fidelity or an existing design file is the starting point.	Buzzy for Figma
Builder MCP	An AI coding agent should build, adapt, inspect, or change the app in stages.	Buzzy Builder MCP
No-code Workspace	You want to edit data, screens, people, settings, functions, tests, or security directly.	The Building Blocks

Project Lifecycle

1. Define the Product

Clarify:

• users, roles, and organizations

• core jobs to be done

• critical workflows and edge cases

• data the app must store

• security and privacy requirements

• external systems, AI services, or APIs

• release target: prototype, internal app, customer-facing web app, or native mobile app

Use App Brief, Flows, and What to Use When.

2. Shape the App Definition

Every serious Buzzy app needs a coherent app definition:

• Brief for product intent

• Flows for journeys and process states

• Data model for datatables, fields, relationships, and access

• Theme for visual direction

• Blueprint for high-level screens and navigation

• Screens for concrete forms, views, fields, filters, actions, and widgets

Use The Building Blocks as the conceptual map.

3. Build and Iterate

Keep the iteration loop short:

1. Make a bounded change.

2. Preview the app.

3. Check the affected data, screens, bindings, and actions.

4. Use the Debug panel when something does not behave correctly.

5. Add or update Tests for important paths.

6. Run Security Review when permissions, Private Data, APIs, MCP, or external integrations are involved.

For agent-assisted changes, use Builder MCP Change and Extension Workflow. For Figma-led work, use Buzzy for Figma.

4. Extend Only Where Needed

Standard Buzzy screens, datatables, forms, fields, and actions should handle most app behavior. Extend when the app needs more:

• Code widgets for custom UI

• Buzzy Functions & Constants for server-side logic, secrets, webhooks, AI calls, and external APIs

• REST API Reference for external systems

• Buzzy Custom MCP to expose app-specific tools to MCP clients

• API and Extension Surfaces when you need to choose between extension paths

5. Test and Review

Before release, create repeatable checks for the workflows users rely on:

• sign in and onboarding

• main create/read/update/delete paths

• search, filter, approval, booking, payment, or support workflows

• role-specific views and admin paths

• functions, widgets, APIs, and MCP-backed behavior

• permission-sensitive and Private Data paths

Use Tests, Testing Approaches, Security Review, and In-App Debugging.

6. Publish and Operate

Publishing depends on the target:

• prototype or internal testing on app.buzzy.buzz

• production web app on a Buzzy deployment

• native iOS or Android app through app stores

• enterprise or single-tenant deployment

Use Buzzy Deployment & App Stores, Publish your app to your Deployment, Software Config Management, and Release Management.

Practical Project Checklist

• The brief states the app purpose, users, roles, and core capabilities.

• Flows cover the main user journeys and decision branches.

• Datatables, fields, and relationships match the workflows.

• Organizations, Teams, Viewers, Team Viewers, field access, and Private Data are configured where needed.

• Blueprint covers public, signed-in, admin, confirmation, and role-specific screens.

• Screens are bound to real datatables and fields.

• Theme is coherent across desktop and mobile.

• Functions, constants, widgets, APIs, and MCP are used only where they add real value.

• Tests cover the workflows that must not break.

• Security Review findings have been read and addressed.

• Deployment, publishing, and support responsibilities are clear.

Related Sections

• Working with Buzzy

• The Building Blocks

• Building with AI Project Workflow

• Buzzy Builder MCP

• Buzzy for Figma

• FAQs