YouGrow DevelopersProducts →

Open source

YouGrow is open source under the AGPL-3.0 licence. You can run it on your laptop in about 15 minutes with no accounts, host your own copy on Google Cloud, and build on it. The repository is set up for coding agents, so Claude Code or Cursor can do most of the work: you mostly approve what it proposes.

What you need

  • Git.
  • Node 24 (Node 22 works).
  • Java 21 or newer, for the Firebase emulators.
  • Claude Code (install) or Cursor (download).

A local run needs no Google Cloud project, no Firebase account and no keys.

Run it on your laptop

With Claude Code

In a terminal
git clone https://github.com/ygai-jezl/vizzyblmrkt yougrow
cd yougrow
claude "Get YouGrow running on my laptop. Follow AGENTS.md."

With Cursor

  1. Clone the repository (the first two lines above) and open the yougrow folder in Cursor.
  2. In the agent chat, send Get YouGrow running on my laptop. Follow AGENTS.md., or open the prompt in Cursor.
  3. Approve the terminal commands it proposes.

What happens next

  1. The agent runs npm run doctor. It checks your machine and prints a fix for anything missing, most often Java 21.
  2. It asks before running npm install.
  3. It starts npm run local: the app on the Firebase emulators, with a made-up brand called Acme. Nothing reaches the internet, and emails are written to the log instead of sent.
  4. Open http://localhost:3002/login, click Sign in with Google, and pick admin@example.com on the emulator's test page.
AI writing, images and knowledge search need a Gemini key. Get one at aistudio.google.com/apikey, add it to .env.local as GEMINI_API_KEY yourself, and restart the local run. Don't paste keys into the chat.

What to ask next

You want toAsk your agent
Find your way aroundGive me a tour of the admin, and show me where each part's code lives.
Build a featureAdd a feature that ... It should ship behind a switch, with tests.
Fix a bugWhen I ..., I see ... Find out why and fix it, with a test.
Check your workCheck my change is ready for a pull request.
Host your own copyHost YouGrow on my Google Cloud project my-project-id. Follow docs/self-host.md.

The agent follows AGENTS.md and five step by step skills in .claude/skills/. Claude Code and Cursor both read them.

Host your own copy

You need a Google Cloud project with billing turned on, the gcloud CLI and the Firebase CLI. Allow about 45 minutes, most of it the first build.

  1. Sign in yourself, in a terminal: gcloud auth login, then gcloud auth application-default login, then firebase login.
  2. Ask your agent: Host YouGrow on my Google Cloud project my-project-id. Follow docs/self-host.md.
  3. It shows a read-only plan (npm run selfhost -- --project my-project-id), then applies one step at a time and asks before each change.
  4. Two steps need you in a browser: connecting your fork of the repository to App Hosting, and turning on Google sign-in in the Firebase console. The agent tells you when.
  5. Check the result: npm run doctor -- --cloud --project my-project-id.

Costs and every step: the self-host guide.

What the agent asks before doing

  • Any deploy or rollout, and any setup step or script that changes a Google Cloud project.
  • Installing packages, git push, and other changes that are hard to undo.
  • It never reads .env.local or secret values.

Claude Code enforces this through the repository's settings. In Cursor, approve terminal commands one at a time, and read any with deploy, selfhost or --apply before you approve.

Full guides