Step 5: Open the prototype

Use the output directory reported by your agent. In this walkthrough, Gemini CLI and Claude Code use different verified paths.

Start the Gemini CLI output

# macOS / Linux
cd ~/my-prototype/prototype
npm install
npm run dev

# Windows PowerShell
cd $HOME\my-prototype\prototype
npm install
npm run dev

Start the Claude Code output

# macOS / Linux
cd ~/my-prototype
npm install
npm run dev

# Windows PowerShell
cd $HOME\my-prototype
npm install
npm run dev

If either agent reports a different output path, use that reported path instead.

You should see:

  VITE v6.x.x  ready in 800ms

  ➜  Local:   http://localhost:5173/
  ➜  Network: use --host to expose

Open the prototype

Open your browser and navigate to:

http://localhost:5173

You will see your prototype running with the three must-have screens you selected in Step 4. Use the navigation to move between screens.

What a complete prototype looks like

• A landing or home screen as the entry point
• Sidebar or bottom navigation linking to all screens
• Realistic placeholder data (numbers, names, dates)
• shadcn/ui components styled to your brand colors
• Responsive layout that works on mobile viewport sizes

Troubleshooting

Port conflict: something is already running on port 5173

# macOS / Linux
npm run dev -- --port 5174

# Windows PowerShell
npm run dev -- --port 5174

Then open http://localhost:5174 instead.

Missing dependencies error

If you see errors like Cannot find module 'xxx', run:

# macOS / Linux
rm -rf node_modules package-lock.json
npm install

# Windows PowerShell
Remove-Item -Recurse -Force node_modules, package-lock.json
npm install

Wrong Node version

The current workflow requires Node.js 20+. If you see an error about the Node version:

# macOS / Linux
node --version

# Windows PowerShell
node --version

If the output is below v20.0.0, update Node.js from https://nodejs.org.

Blank screen with no errors

Open your browser DevTools (F12), check the Console tab for errors, and paste the full error message into your current Gemini CLI or Claude Code session. The agent can fix it.