Track influencer campaigns, post analytics, and sales growth in one place. Optional n8n automation can send outreach emails when you add influencers and update status when replies arrive.

• Node.js 18+ and npm
• PostgreSQL
• Docker (optional) — only needed if you use n8n

npm install
cd server && npm install
cd ../client && npm install

Copy the example env file and edit values:

cp .env.example server/.env

Set at least DATABASE_URL, JWT_SECRET, and CLIENT_URL. Optional n8n variables go in the same file (see Environment variables).

cd server && npx prisma migrate dev --name init

Or, without migration history:

cd server && npx prisma db push

From the repository root:

npm run dev

• API: http://localhost:3001
• Web app: http://localhost:3000

Run processes separately if you prefer:

npm run dev:server   # API only
npm run dev:client   # Client only

The client defaults NEXT_PUBLIC_API_URL to http://localhost:3001 if unset.

n8n runs in Docker. This repo includes two Compose files:

1. Start n8n

   docker compose up -d

   Or: npm run docker:up (same command).

2. Open http://localhost:5678 and complete the first-run wizard if prompted.

3. Import workflows — In n8n: Workflows → Import from File, then add:

   • n8n-workflows/influencer-outreach.json — webhook from MarketIt → send email → notify API
   • n8n-workflows/influencer-reply-listener.json — IMAP poll → notify API when someone replies

4. Credentials in n8n

   • Outreach: Configure SMTP on the Send Email node (or your provider’s email node).
   • Reply listener: Configure IMAP on the Email Trigger node so n8n can read the inbox you monitor for replies.

5. Activate the outreach workflow and copy its production webhook URL (path includes /webhook/…). Put that in server/.env:

   N8N_WEBHOOK_URL="http://localhost:5678/webhook/influencer-created"

   Use the exact URL n8n shows for your environment (localhost vs public host).

6. Shared secret — Set N8N_WEBHOOK_SECRET in server/.env to a long random string. In both imported workflows, replace REPLACE_WITH_N8N_WEBHOOK_SECRET in the Authorization header with that same value (Bearer <secret>).

7. HTTP nodes calling MarketIt — Workflows include placeholder API URLs (e.g. https://YOUR-RENDER-API.onrender.com). Point them at your running API, for example:

   • Same machine, API on the host, n8n in Docker: http://host.docker.internal:3001/api/webhooks/n8n-email-sent and …/n8n-influencer-reply (Docker Desktop provides host.docker.internal).

Restart the API after changing server/.env.

1. Copy the example file and fill in values:

   cp .env.n8n.example .env.n8n

   Set N8N_PUBLIC_HOST (no https://), N8N_BASIC_AUTH_USER, and a strong N8N_BASIC_AUTH_PASSWORD. .env.n8n is gitignored.

2. Start the stack:

   docker compose -f docker-compose.n8n.yml --env-file .env.n8n up -d

   The UI listens on 127.0.0.1:5678 only; terminate TLS and route traffic with nginx (or similar) on your N8N_PUBLIC_HOST domain.

3. Set N8N_WEBHOOK_URL in server/.env to the public webhook URL n8n shows (must match WEBHOOK_URL / host configuration).

• Influencers — Organize contacts into Current (replied), Waiting, Past Success, and Past Failure.
• Email automation — Adding an influencer with an email can trigger outreach via n8n; reply detection can move them to “replied” when configured.
• Analytics — Per-post stats (likes, comments, views); refresh cadence ~30s; manual updates where the Instagram API is limited.
• Growth — Sales-over-time chart with markers when influencers post.

Variables below are read from server/.env (and client/.env.local for NEXT_PUBLIC_* if you use one).

For Docker-based n8n with docker-compose.n8n.yml, see .env.n8n.example.