Berripop: grow together
A playful, mobile-first personal growth prototype (Next.js App Router + TypeScript). Friends, partners and small groups answer tiny daily questions, earn XP, and move through a shared 21-day journey.
Run it
Requires Node.js 20.9+ and the linked Vercel project (Neon + Clerk are provisioned through the Vercel Marketplace).
npm install
vercel env pull .env.local --yes
ALLOW_PRODUCTION_DB=1 npm run db:migrate # the only database is production; back it up first
npm run dev
Then open http://localhost:3000, sign up, and create a circle.
Shared circles: architecture
- Auth: Clerk (
middleware.ts, /sign-in, /sign-up). Clerk's screens use the app language through the kozos-locale cookie.
- Database: Neon Postgres via Drizzle. The schema is
lib/db/schema.ts, and the migration is drizzle/0000_init.sql. Tables: users, circles, circle_members, custom_questions, circle_questions, saved_questions, answers, answer_reactions, daily_quests, participations, shared_journey_days, xp_events, achievements, circle_milestones, circle_events, user_prefs.
- Server:
lib/server/actions.ts (server actions: authenticate, then delegate) → lib/server/service.ts (all circle logic) → lib/server/snapshot.ts (the privacy-filtered data a member may see).
- Shared rules:
lib/domain/rules.ts, used by both server and client: daily quest pick, journey availability, individual vs. shared completion, XP, achievements and milestones. lib/domain/view.ts derives the display state from a snapshot.
Rules
- Privacy: answers are private by default. Other members' answer text is only selected when the author shared it, and only for current members. Feed events and participation never contain answer text. Making an answer private again hides it immediately.
- Daily circle quest: one question per circle per day (Europe/Budapest calendar), stored in
daily_quests. Each member completes it on their own; participation is a participations row.
- Journey, individual completion: a member saved an answer for that day (private is fine). One new stop per member per day; finished stops can be revisited.
- Journey, shared completion: recorded in
shared_journey_days once every member of a circle with 2+ members has completed the day. It is never removed.
- XP:
xp_events has a unique (circle_id, ref), so no reward can be granted twice. Shared rewards (user_id null) go to the circle. Deleting an answer keeps its participation record, XP and badges.
- Invites:
/join/<code>. The invitee signs in and taps Join. Owners can create a new link (the old one stops working) and remove members; members can leave.
Verify
ALLOW_PRODUCTION_DB=1 npm run verify:shared # 30 end-to-end checks against the database with temporary users
npm run lint && npm run typecheck && npm run build
The verify:* scripts and db:migrate refuse to run against a remote database (for
Berripop that is production) unless ALLOW_PRODUCTION_DB=1 is set (scripts/db-guard.ts).
Test users and their analytics events are deleted at the end of each run.
Remaining production blockers
- Clerk production instance is live. Deleting a user in the Clerk dashboard deletes their data via
POST /api/clerk/webhook (event user.deleted; renewal of a paid subscription is turned off first). It needs a webhook endpoint in the Clerk dashboard and CLERK_WEBHOOK_SIGNING_SECRET in Vercel (Production); without it the route answers 503.
- Migrations are applied manually (
npm run db:migrate); add them to the deploy pipeline.
- No rate limiting on server actions yet; no email or push notifications.
- Anyone with a valid invite code can join (no owner approval step).
- Inner World moments stay device-only by design. Answers from the earlier browser-only prototype are not migrated.
Subscriptions (Free / Premium)
Free stays useful forever. Premium adds more room and more AI help. Payments use Stripe, provisioned as a test-mode sandbox through the Vercel Marketplace: no real money moves until a live Stripe account is connected.
What each plan gets (lib/billing/plans.ts)
| Free | Premium |
|---|
| Active growth goals | 1 | 5 |
| AI follow-up questions / week | 5 | 60 |
| Own circles (joining is unlimited) | 1 | 5 |
| Weekly AI growth summary | – | ✓ |
| Price | 0 Ft | 2 990 Ft / month or 23 990 Ft / year |
Everything else (daily quest, 21-day shared journey, sharing, XP, badges, Inner World, viewing, editing and deleting your own data) is free. Premium never unlocks other people's private answers. The pricing page lists features that aren't built yet (adaptive journeys, AI exercises, Berripop cosmetics) under "Planned", never as included.
- AI allowance: resets every Monday 00:00 Europe/Budapest. Only an explicit "Ask Berripop" or summary request counts. Reserving an allowance is a single conditional upsert (
consumeAiAllowance), so parallel requests can't exceed the limit; a failed AI call is refunded. Basic daily quests never use the allowance.
- AI provider: Vercel AI Gateway with
openai/gpt-5-mini by default, called with minimal reasoning (override with AI_GATEWAY_MODEL). It is chosen because the team's free AI Gateway credit covers it; Claude and Gemini models need paid credit. The Gateway catalog marks it no_training for all providers. The member's draft is sent only when they ask, isn't stored, and only token counts are logged (ai_calls).
This is the beginning of the README. Read the rest at the original. Read the full README ↗
