---
title: "Acme Pulse — project README"
url: https://memory.wiki/SWys7jXa
updated: 2026-05-16T14:17:17.510Z
hub: https://memory.wiki/hub/demo
bundle_count: 1
concept_count: 12
source: "demo-seed"
---
# Acme Pulse — project README

Acme Pulse is a landing-page builder for marketing teams. Build, A/B test, ship — all without engineering bandwidth.

## Stack

| Layer | Choice | Why |
|---|---|---|
| Frontend | Next.js 15 (App Router) | RSC + Cache Components |
| UI | Tailwind 4 + shadcn/ui | Atom-grade primitives, no design-system overhead |
| Auth + DB | Supabase | Magic link + RLS, no separate auth service |
| AI | Vercel AI Gateway | Provider failover, zero data retention |
| Email | Resend | Transactional + marketing |
| Hosting | Vercel | Same vendor as AI Gateway |

## Folder structure

```text
apps/web/
├── src/
│   ├── app/                # Routes (App Router)
│   ├── components/         # Atoms / molecules / organisms
│   ├── lib/                # Shared helpers (db, auth, ai)
│   └── styles/             # Tailwind config + globals
├── supabase/
│   └── migrations/         # Numbered SQL migrations
└── public/
```

## Local dev

```bash
pnpm install
cp .env.example .env.local       # fill SUPABASE_URL, OPENAI_API_KEY etc.
pnpm db:up                       # local supabase
pnpm dev                         # → http://localhost:3000
```

## Deploy

- `main` → Vercel preview
- `production` branch → mdfy.app
- Migrations run via `supabase db push --include-all` (NOT auto on deploy)

## Where to look when

- Auth flow questions → `docs/auth.md` (this bundle)
- DB / migration questions → `docs/db-schema.md`
- API endpoint conventions → `docs/api-conventions.md`
- UI component patterns → `docs/ui-patterns.md`
- "Why we chose X" → `docs/decision-log.md`
- Open questions / parking lot → `docs/open-questions.md`


---

## Concepts in this document
- **Supabase** _(entity)_
  Backend-as-a-service providing authentication, database, and row-level security without separate auth overhead.
- **Vendor consolidation** _(concept)_
  The operational principle of reducing authentication surfaces, SDKs, and control planes by keeping vector search within the existing Postgres infrastructure.
- **pgvector** _(entity)_
  PostgreSQL extension providing vector data type and HNSW indexing for efficient similarity search.
- **Authentication** _(tag)_
  Core security domain covering user identity, session management, and authorization patterns.
- **Database Design** _(tag)_
  Data modeling domain including schema design, migrations, and query optimization strategies.
- **API Design** _(tag)_
  RESTful interface design covering endpoints, error handling, and client-server communication.
- **Resend** _(entity)_
  Email service provider supporting both transactional and marketing communication channels.
- **Next.js App Router** _(entity)_
  Chosen routing framework leveraging RSC and Server Actions to match the project's data-heavy, read-mostly workload.
- **Vercel AI Gateway** _(entity)_
  AI provider abstraction layer offering failover and zero data retention for model access.
- **Next.js 15** _(entity)_
  Chosen frontend framework leveraging React Server Components and caching for performance.
- **Row-level security** _(concept)_
  Supabase RLS capability co-locating authentication and authorization with data, justifying single-vendor consolidation.
- **React Hook Form** _(entity)_
  Primary form handling library paired with Zod schemas for both client and server validation.

## Concept relations (within this doc's concepts)
- **Supabase** enables approach **Vendor consolidation**
- **Supabase** implements **Row-level security**
- **Supabase** hosts **pgvector**
- **Vercel AI Gateway** similar pattern **Resend**
- **Supabase** exemplifies approach **Vendor consolidation**
- **Row-level security** supports decision **Vendor consolidation**
- **Supabase** reduces complexity **Vendor consolidation**
- **Row-level security** supports **Vendor consolidation**
- **Supabase** integrates **pgvector**
- **Supabase** exemplifies strategy **Vendor consolidation**
- **Supabase** provides **Row-level security**
- **Vendor consolidation** guides **Supabase**
- **Vendor consolidation** guides **Vercel AI Gateway**

## Bundles containing this document
- [Cross-tool dev workflow](https://memory.wiki/b/p_mdtSk0)
  > Acme Pulse, a fictional landing-page builder. The seven docs in this bundle are the project's living context — README, auth pattern, DB schema, API conventions, UI patterns, decision log, open questio

_Hub canonical:_ https://memory.wiki/hub/demo
_Concept digest:_ https://memory.wiki/raw/hub/demo?digest=1&compact=1