Build Your First App with Piezas.ai
Piezas.ai is a set of building blocks (APIs) that your AI coding agents can assemble together to create the backend for production-grade software. We have a team of senior engineers behind these building blocks, architecting, developing, reviewing, auditing, and testing these blocks one by one. To…
Piezas.ai is a set of building blocks (APIs) that your AI coding agents can assemble together to create the backend for production-grade software. We have a team of senior engineers behind these building blocks, architecting, developing, reviewing, auditing, and testing these blocks one by one.
To build software with Piezas, you will need a few things:
- A Piezas account
- An AI Coding tool: Claude Code, Codex, Cursor or Windsurf
- npx command line tool (npx install)
- A good idea of what you want to build
Let's Start Building:
You don't write code — you describe what you want to an AI assistant, and it builds your app against Piezas. The whole loop is spec → design → build → deploy. Here's how to get the most out of it.
1. Set up your project
npx piezas login
npx piezas init my-app
init connects the folder to your Piezas app and gives your AI assistant two things: the platform contract (the rules of every Piezas building block, so the assistant builds against reality instead of guessing) and a guided spec mode.
2. Start with a spec — let the AI interview you
Open the folder in Claude Code, Cursor, Codex, or Windsurf and run:
/piezas-spec your idea here
(In Cursor, Codex, or Windsurf, ask for "Piezas spec mode".) The assistant becomes a product manager and asks you one question at a time — MVP or full version? who are the users? what do they need to do? — then writes a clear SPEC.md. This is the highest-value step: a good spec means the assistant builds the right thing the first time.
3. Get a design (optional, recommended)
When the spec is ready, it offers a paste-ready design prompt for Claude. Say yes and it writes a DESIGN_PROMPT.md — drop that into Claude Design (or another design tool) to get a design brief and screen layouts before building starts, so your app looks polished instead of default.
4. Build from the spec
Tell the assistant "Build this from SPEC.md." Because it has the contract and your spec, it builds the whole app on Piezas — data, logic, and screens. Review and refine in plain English. For a commercial product, we highly recommend you have test scripts set up to test specific functionalities, run automated tests, as well as a regression test script.
5. Publish
npx piezas deploy
You get a live link to share, and you can manage the app and attach a domain on the Piezas dashboard.
No terminal? (coming soon) Piezas is adding a connector so you can build straight from ChatGPT or Claude Desktop — no npx, no local setup. Ask your admin whether it's available for your account yet.