Docs
    App Growth AgentUpdated Jul 13, 2026MD

    Shopify App Growth Agent Micro‑SaaS

    Markdown file

    README.md

    Shopify App Growth Agent Micro‑SaaS

    Autonomous early‑user acquisition + compliant review prompting pipeline for Shopify apps.

    Documentation (start here)

    • STATUS.md — quick entrypoint to current status
    • HANDOFF.md — quick entrypoint to latest handoff
    • docs/STATUS.md — where we are + next steps
    • docs/HANDOFF.md — latest handoff + how to create tomorrow’s
    • docs/RUNBOOK.md — how to run/debug locally
    • docs/ARCHITECTURE.md — system overview
    • CHANGELOG.md — user-facing change history

    Stack

    • Next.js (App Router)
    • Tailwind CSS + shadcn/ui
    • Prisma + Postgres
    • NextAuth
    • BullMQ + Redis

    Local dev

    1. Install deps
    pnpm i

    (npm i also works.)

    1. Create env
    cp .env.example .env
    1. Start Postgres + Redis (docker recommended) If you have Docker running:
    docker compose up -d
    1. Run migrations
    pnpm prisma migrate dev
pnpm prisma db seed
    1. Start web
    pnpm dev
    1. Start worker
    pnpm worker

    Daily handoff workflow

    At the end of a session:

    pnpm handoff:new

    Then fill in docs/handoffs/YYYY-MM-DD.md and update docs/HANDOFF.md to point to it.

    Core flows

    • /api/webhooks/shopify-events: your Shopify app posts telemetry here
    • /api/agent/run: kicks a campaign tick (can be called by cron)

    Guardrails

    • No incentivized review language
    • DM caps and follow‑up limits
    • Policy lint blocks sends

    Deploy

    Works on Render/Vercel (web) + a worker dyno + managed Postgres + Redis.

    Documentation

    • docs/ — canonical docs root.
    • docs/index.md — VitePress home page.
    • docs-site/ — VitePress wrapper for local dev (npm --prefix docs-site run dev).