Hello, World

Piezas is a backend you don't build. You describe the app you want, an AI assistant builds it on Piezas, and you publish it to the web — the data, logins, scheduling, notifications, and hosting are already running. No servers, and no code you write by hand.

Here's the whole journey — about five minutes to your first live app.

---

1. Get a Piezas account

Sign up at app.piezas.ai. You get an organization and your first app — your private workspace, with its own data and its own web address.

[Screenshot placeholder: the Piezas new-app screen]

2. Install the helper (one-time)

Piezas uses a small tool called npx to set up and publish projects. Never used a terminal? You'll only copy-paste a few commands.

• Don't have it? Install Node.js from nodejs.org — it includes npx.
• Check it: in Terminal (Mac) or Command Prompt (Windows), type npx --version.

3. Create your project

npx piezas login
npx piezas init my-app

login approves access in your browser; init creates a folder wired to your app, with a guided spec mode and AI instructions ready to go.

4. Describe it — the AI interviews you

Open the folder in an AI assistant (Claude Code, Cursor, Codex, or Windsurf) and run:

/piezas-spec

The assistant becomes a product manager and asks you one question at a time, then writes a complete SPEC.md — no code, just your answers. When it's done, it offers a paste-ready design prompt for Claude Design so you can get a polished look and screen layouts too.

5. Build and publish

Tell the assistant "Build this from SPEC.md" — it creates the app on Piezas. When you're happy:

npx piezas deploy

You get a live link to share. That's it.

---

Where to go next

• Tutorials — build a real app end to end (a CRM, then add sign-in, then a booking page).
• How-To Guides — short answers to specific tasks (custom domains, inviting teammates, API keys, MFA).
• Build with an AI Agent — the full story on spec mode and Claude Design.