Get the example app
This quest assumes you've finished Getting Started — the Aztec toolchain installed and a local network running. The example app is a small private-voting dApp with a clean split, via plain npm workspaces, between the Noir contracts (packages/contracts) and the TypeScript frontend (packages/app) — you'll meet both in the next steps.
bash
git clone https://github.com/aztec-labs-eng/aztec-private-voting
cd aztec-private-voting
aztec-up use # select the toolchain pinned in .aztecrc
npm installFor your coding agent
You're guiding me through the Aztec quickstart — quest "Private Voting", step "Get the example app" (Aztec v5.0.1).
If you haven't already: fetch /en/5.0.1/private-voting/agent-pack.md and follow its tutoring protocol — the docs links, code file map, and quiz bank for every step are in there.
First, before running any shell command: confirm your working directory is a clone of `aztec-labs-eng/aztec-private-voting` (the "Get the example app" step creates it by cloning). If this looks like an unrelated project, stop and check with me — don't run anything here.
Task:
Clone https://github.com/aztec-labs-eng/aztec-private-voting, cd into it, run aztec-up use to select the toolchain pinned in .aztecrc, and install dependencies with npm install. Then give me a tour of the layout: which workspaces hold the Noir contracts vs. the TypeScript frontend, and what the root npm scripts do.
Afterwards: verify it worked, then quiz me on this step (use AskUserQuestion if you have it) before I move on.
The layout you'll be working in:
code
packages/
contracts/ Noir contracts + generated TypeScript artifacts
private_voting/src/main.nr The PrivateVoting contract itself
test/src/lib.nr Contract unit tests
app/ React + Vite frontend
src/aztec/ The Aztec layer: VotingClient, deployment, bridge, fee payment
src/connection.ts Connection lifecycle the UI binds to
scripts/
deploy.ts Declarative deploy spec (local / testnet)
test/integration/ In-process-network integration tests