DLX Designs

Bespoke menswear enquiry

Tell us what you need. Verified inquiries are handled personally.

\n\n \n\n

DLX Designs · Lagos & Abeokuta

\n\n \n \n\n","label",[168,66],"frontend","pulls","branches","forks","envVars",{"_176":178,"_179":26},"connections",{"_176":26,"_177":26},"count","unfilledCount",3,"emptyCount",{"_33":495,"_13":425,"_64":420,"_43":-5,"_35":36,"_160":178,"_161":95,"_37":496,"_39":26,"_67":266,"_164":-5,"_68":24,"_166":-5,"_226":497,"_17":498},{"_33":491,"_13":474,"_64":468,"_43":420,"_35":36,"_160":178,"_161":95,"_37":492,"_39":26,"_67":266,"_164":-5,"_68":24,"_166":-5,"_226":493,"_17":494},{"_33":483,"_13":484,"_64":485,"_43":468,"_35":36,"_160":486,"_161":95,"_37":487,"_39":163,"_67":251,"_164":488,"_68":24,"_166":-5,"_226":489,"_17":490},{"_33":475,"_13":476,"_64":477,"_43":468,"_35":36,"_160":478,"_161":95,"_37":479,"_39":280,"_67":251,"_164":480,"_68":24,"_166":-5,"_226":481,"_17":482},{"_33":465,"_13":466,"_64":467,"_43":468,"_35":36,"_160":469,"_161":95,"_37":470,"_39":178,"_67":251,"_164":471,"_68":24,"_166":-5,"_226":472,"_17":473},{"_33":457,"_13":458,"_64":459,"_43":420,"_35":36,"_160":460,"_161":95,"_37":461,"_39":26,"_67":251,"_164":462,"_68":24,"_166":-5,"_226":463,"_17":464},{"_33":450,"_13":395,"_64":451,"_43":420,"_35":36,"_160":452,"_161":95,"_37":453,"_39":163,"_67":251,"_164":454,"_68":24,"_166":-5,"_226":455,"_17":456},{"_33":442,"_13":443,"_64":444,"_43":420,"_35":36,"_160":445,"_161":95,"_37":446,"_39":26,"_67":251,"_164":447,"_68":24,"_166":-5,"_226":448,"_17":449},{"_33":434,"_13":435,"_64":436,"_43":420,"_35":36,"_160":437,"_161":95,"_37":438,"_39":178,"_67":251,"_164":439,"_68":24,"_166":-5,"_226":440,"_17":441},{"_33":426,"_13":427,"_64":428,"_43":420,"_35":36,"_160":429,"_161":95,"_37":430,"_39":26,"_67":251,"_164":431,"_68":24,"_166":-5,"_226":432,"_17":433},{"_33":417,"_13":418,"_64":419,"_43":420,"_35":36,"_160":122,"_161":95,"_37":421,"_39":26,"_67":251,"_164":422,"_68":24,"_166":-5,"_226":423,"_17":424},{"_33":413,"_13":404,"_64":397,"_43":-5,"_35":36,"_160":398,"_161":95,"_37":414,"_39":26,"_67":266,"_164":-5,"_68":24,"_166":-5,"_226":415,"_17":416},{"_33":405,"_13":406,"_64":407,"_43":397,"_35":36,"_160":408,"_161":95,"_37":409,"_39":163,"_67":400,"_164":410,"_68":24,"_166":-5,"_226":411,"_17":412},{"_33":394,"_13":395,"_64":396,"_43":397,"_35":36,"_160":398,"_161":95,"_37":399,"_39":26,"_67":400,"_164":401,"_68":24,"_166":-5,"_226":402,"_17":403},{"_33":389,"_13":388,"_64":382,"_43":-5,"_35":36,"_160":390,"_161":95,"_37":391,"_39":26,"_67":266,"_164":-5,"_68":24,"_166":-5,"_226":392,"_17":393},{"_33":379,"_13":380,"_64":381,"_43":382,"_35":36,"_160":383,"_161":95,"_37":384,"_39":163,"_67":21,"_164":385,"_68":24,"_166":-5,"_226":386,"_17":387},{"_33":375,"_13":366,"_64":360,"_43":-5,"_35":36,"_160":370,"_161":95,"_37":376,"_39":26,"_67":266,"_164":-5,"_68":24,"_166":-5,"_226":377,"_17":378},{"_33":367,"_13":368,"_64":369,"_43":360,"_35":36,"_160":370,"_161":95,"_37":371,"_39":26,"_67":21,"_164":372,"_68":24,"_166":-5,"_226":373,"_17":374},{"_33":357,"_13":358,"_64":359,"_43":360,"_35":36,"_160":361,"_161":95,"_37":362,"_39":26,"_67":21,"_164":363,"_68":24,"_166":-5,"_226":364,"_17":365},{"_33":353,"_13":349,"_64":346,"_43":-5,"_35":36,"_160":347,"_161":95,"_37":354,"_39":26,"_67":266,"_164":-5,"_68":24,"_166":-5,"_226":355,"_17":356},{"_33":343,"_13":344,"_64":345,"_43":346,"_35":36,"_160":347,"_161":95,"_37":348,"_39":26,"_67":349,"_164":350,"_68":24,"_166":-5,"_226":351,"_17":352},{"_33":339,"_13":168,"_64":159,"_43":-5,"_35":36,"_160":163,"_161":95,"_37":340,"_39":26,"_67":266,"_164":-5,"_68":24,"_166":-5,"_226":341,"_17":342},{"_33":335,"_13":317,"_64":311,"_43":159,"_35":36,"_160":163,"_161":95,"_37":336,"_39":26,"_67":266,"_164":-5,"_68":24,"_166":-5,"_226":337,"_17":338},{"_33":326,"_13":327,"_64":328,"_43":311,"_35":36,"_160":329,"_161":95,"_37":330,"_39":331,"_67":251,"_164":332,"_68":24,"_166":-5,"_226":333,"_17":334},{"_33":318,"_13":319,"_64":320,"_43":311,"_35":36,"_160":321,"_161":95,"_37":322,"_39":163,"_67":251,"_164":323,"_68":24,"_166":-5,"_226":324,"_17":325},{"_33":308,"_13":309,"_64":310,"_43":311,"_35":36,"_160":312,"_161":95,"_37":313,"_39":26,"_67":251,"_164":314,"_68":24,"_166":-5,"_226":315,"_17":316},{"_33":158,"_13":66,"_64":65,"_43":159,"_35":36,"_160":75,"_161":95,"_37":305,"_39":163,"_67":21,"_164":165,"_68":24,"_166":-5,"_226":306,"_17":307},{"_33":298,"_13":299,"_64":300,"_43":159,"_35":36,"_160":163,"_161":95,"_37":301,"_39":26,"_67":21,"_164":302,"_68":24,"_166":-5,"_226":303,"_17":304},{"_33":291,"_13":292,"_64":293,"_43":159,"_35":36,"_160":163,"_161":95,"_37":294,"_39":26,"_67":251,"_164":295,"_68":24,"_166":-5,"_226":296,"_17":297},{"_33":284,"_13":285,"_64":286,"_43":159,"_35":36,"_160":222,"_161":95,"_37":287,"_39":163,"_67":251,"_164":288,"_68":24,"_166":-5,"_226":289,"_17":290},{"_33":279,"_13":278,"_64":272,"_43":-5,"_35":36,"_160":280,"_161":95,"_37":281,"_39":26,"_67":266,"_164":-5,"_68":24,"_166":-5,"_226":282,"_17":283},{"_33":269,"_13":270,"_64":271,"_43":272,"_35":36,"_160":273,"_161":95,"_37":274,"_39":163,"_67":251,"_164":275,"_68":24,"_166":-5,"_226":276,"_17":277},{"_33":264,"_13":255,"_64":248,"_43":-5,"_35":36,"_160":249,"_161":95,"_37":265,"_39":26,"_67":266,"_164":-5,"_68":24,"_166":-5,"_226":267,"_17":268},{"_33":256,"_13":257,"_64":258,"_43":248,"_35":36,"_160":259,"_161":95,"_37":260,"_39":26,"_67":251,"_164":261,"_68":24,"_166":-5,"_226":262,"_17":263},{"_33":245,"_13":246,"_64":247,"_43":248,"_35":36,"_160":249,"_161":95,"_37":250,"_39":26,"_67":251,"_164":252,"_68":24,"_166":-5,"_226":253,"_17":254},{"_33":238,"_13":239,"_64":240,"_43":-5,"_35":36,"_160":163,"_161":95,"_37":241,"_39":26,"_67":21,"_164":242,"_68":24,"_166":-5,"_226":243,"_17":244},{"_33":229,"_13":230,"_64":231,"_43":-5,"_35":36,"_160":232,"_161":95,"_37":233,"_39":234,"_67":21,"_164":235,"_68":24,"_166":-5,"_226":236,"_17":237},{"_33":218,"_13":219,"_64":93,"_43":-5,"_35":36,"_160":220,"_161":95,"_37":221,"_39":222,"_67":223,"_164":224,"_68":24,"_166":225,"_226":227,"_17":228},"47858962-a30d-4978-b3f8-7982cdfc2bad","index.ts",86,["D",1788499627158],10,"http","import { parseVal, serveFile, serveImmutableFile } from \"https://esm.town/v/std/utils/index.ts\";\nimport { Hono } from \"npm:hono\";\nimport { Root } from \"./frontend/root.tsx\";\nimport {\n listLeads,\n setLeadStatus,\n stageDistribution,\n topSources,\n topSignals,\n} from \"./lib/store.ts\";\nimport { ingestLead } from \"./backend/worker/ingest.ts\";\nimport { nextStage } from \"./backend/pipeline.ts\";\nimport {\n verifyWebhook,\n handleEvent,\n listSignals,\n promoteSignal,\n} from \"./backend/instagram.ts\";\nimport {\n addProspect,\n listProspects,\n contactProspect,\n convertProspect,\n} from \"./backend/outbound.ts\";\n\nconst app = new Hono();\n\n// Serve the (never-cached) HTML shell at the root and as the dashboard\napp.get(\"/\", (c) => c.html(Root()));\napp.get(\"/dashboard\", (c) => c.html(Root()));\n\n// Standalone, embeddable lead-capture form (Option A: website ingestion)\napp.get(\"/capture\", (c) => serveFile(\"/frontend/capture.html\"));\n\n// Serve frontend files at the version-addressed URLs Root() stamps, cached immutably\napp.get(\"/__immutable/*\", (c) => serveImmutableFile(c.req.path));\n\n// View source redirect\napp.get(\"/source\", (c) => c.redirect(parseVal().links.self.val));\n\n// --- Lead API -----------------------------------------------------------\n\n// GET verified (already-qualified) leads for the dashboard\napp.get(\"/api/leads\", async (c) => {\n const leads = await listLeads(100);\n return c.json(leads);\n});\n\n// POST an inbound lead: { name, gmail, message, source }\n// Runs the strict qualification engine. Only high-intent leads are stored;\n// budget seekers and duplicates are rejected (422) and never persisted.\napp.post(\"/api/ingest\", async (c) => {\n const body = await c.req.json().catch(() => undefined);\n const outcome = await ingestLead((body as object) ?? {});\n return c.json(outcome, outcome.decision === \"reject\" ? 422 : 201);\n});\n\n// Move a lead forward in the pipeline (or set any valid stage).\n// Automatically advances when no stage body is given (\"next\").\napp.post(\"/api/leads/:id/status\", async (c) => {\n const id = c.req.param(\"id\");\n const body = (await c.req.json().catch(() => undefined)) as\n | { stage?: unknown; note?: unknown }\n | undefined;\n const lead = await listLeads(200);\n const existing = lead.find((l) => l.id === id);\n if (!existing) return c.json({ error: \"lead not found\" }, 404);\n\n let target: string;\n if (body?.stage) {\n target = String(body.stage);\n } else {\n const nxt = nextStage(existing.status as never);\n if (!nxt) return c.json({ error: \"terminal stage\", lead: existing });\n target = nxt;\n }\n\n const updated = await setLeadStatus(id, target, String(body?.note ?? \"\"));\n return c.json(updated ?? { error: \"lead not found\" }, updated ? 200 : 404);\n});\n\n// Analytics — what actually converts (learn layer).\napp.get(\"/api/analytics\", async (c) => {\n const [stages, sources, signals] = await Promise.all([\n stageDistribution(),\n topSources(8),\n topSignals(8),\n ]);\n return c.json({ stages, sources, signals });\n});\n\n// --- Instagram webhook (Meta Business app required) -----------------------\n// GET: Meta's subscription verification handshake.\napp.get(\"/api/instagram/webhook\", async (c) => {\n const challenge = await verifyWebhook(c.req.query());\n if (challenge === null) return c.text(\"verification failed\", 403);\n return c.text(challenge);\n});\n\n// POST: Meta pushes real DM/comment events here.\napp.post(\"/api/instagram/webhook\", async (c) => {\n const body = await c.req.json().catch(() => null);\n if (!body) return c.json({ error: \"invalid payload\" }, 400);\n const stored = await handleEvent(body);\n return c.json({ ok: true, captured: stored });\n});\n\n// List captured Instagram signals (real messages, no fabricated contacts).\napp.get(\"/api/signals\", async (c) => c.json(await listSignals(50)));\n\n// Promote a signal to a VERIFIED lead once the email is captured.\napp.post(\"/api/signals/:id/promote\", async (c) => {\n const id = c.req.param(\"id\");\n const body = (await c.req.json().catch(() => undefined)) as\n | { email?: unknown; phone?: unknown }\n | undefined;\n const email = String(body?.email ?? \"\").trim();\n if (!email) return c.json({ ok: false, reason: \"email required\" }, 400);\n const out = await promoteSignal(id, email, String(body?.phone ?? \"\").trim());\n return c.json(out, out.ok ? 200 : 422);\n});\n\n// --- Prospecting automaton (Refine -> Act) -------------------------------\n\n// Add a REAL public signal as a prospect (handle + message, no fabricated contact).\napp.post(\"/api/prospects\", async (c) => {\n const body = (await c.req.json().catch(() => undefined)) as\n | { handle?: unknown; name?: unknown; email?: unknown; phone?: unknown; message?: unknown; source?: unknown; source_url?: unknown }\n | undefined;\n if (!body?.handle || !body?.message) {\n return c.json({ ok: false, reason: \"handle and message are required\" }, 400);\n }\n const p = await addProspect({\n handle: String(body.handle),\n name: body.name ? String(body.name) : undefined,\n email: body.email ? String(body.email) : undefined,\n phone: body.phone ? String(body.phone) : undefined,\n message: String(body.message),\n source: body.source ? String(body.source) : undefined,\n source_url: body.source_url ? String(body.source_url) : undefined,\n });\n return c.json({ ok: true, prospect: p }, 201);\n});\n\n// List the prospect queue, strongest intent first.\napp.get(\"/api/prospects\", async (c) => c.json(await listProspects(50)));\n\n// Auto-draft + (optionally) send the first touch. Dry-run by default.\napp.post(\"/api/prospects/:id/contact\", async (c) => {\n const id = c.req.param(\"id\");\n const out = await contactProspect(id);\n return c.json(out, out.ok ? 200 : 422);\n});\n\n// Confirm the contact for a prospect -> becomes a VERIFIED pipeline lead.\napp.post(\"/api/prospects/:id/convert\", async (c) => {\n const id = c.req.param(\"id\");\n const body = (await c.req.json().catch(() => undefined)) as\n | { email?: unknown; phone?: unknown }\n | undefined;\n const email = String(body?.email ?? \"\").trim();\n if (!email) return c.json({ ok: false, reason: \"email required\" }, 400);\n const out = await convertProspect(id, email, String(body?.phone ?? \"\").trim());\n return c.json(out, out.ok ? 200 : 422);\n});\n\n// --- Google Business Profile intake ---------------------------------------\n// Real GBP-originated inquiry (review, Q&A, message a VA/owner copies in).\n// Becomes a scored prospect in the Command Center, source-tagged, ready to\n// draft + convert. Coordinates: reviewer name/handle, message, optional contact.\napp.post(\"/api/gbp\", async (c) => {\n const body = (await c.req.json().catch(() => undefined)) as\n | { reviewer?: unknown; name?: unknown; email?: unknown; phone?: unknown; message?: unknown; star?: unknown; permalink?: unknown }\n | undefined;\n const message = String(body?.message ?? \"\").trim();\n if (!message) {\n return c.json({ ok: false, reason: \"message is required (the actual review/Q&A text)\" }, 400);\n }\n const reviewer = String(body?.reviewer ?? body?.name ?? \"\").trim() || \"gbp-reviewer\";\n const p = await addProspect({\n handle: reviewer,\n name: body?.name && String(body.name) !== reviewer ? String(body.name) : reviewer,\n email: body?.email ? String(body.email) : undefined,\n phone: body?.phone ? String(body.phone) : undefined,\n message,\n source: \"google-business-profile\",\n source_url: body?.permalink ? String(body.permalink) : undefined,\n });\n return c.json({ ok: true, prospect: p }, 201);\n});\n\n// Unwrap and rethrow Hono errors as the original error\n// If you delete this, all errors will be \"Internal Server Error\"\napp.onError((err) => Promise.reject(err));\n\n// HTTP vals expect an exported \"fetch handler\"\n// This is how you \"run the server\" in Val Town with Hono\nexport default app.fetch;\n","dlx-leads","children",[],[219],"45371fdf-4ad7-4045-9c9f-a1f064977147","README.md","01a06811-df40-730d-85ee-161b7548ebf9",87,["D",1788499645589],24,"# DLX Designs · Verified Lead Intelligence Engine\n\nProduction-ready lead-generation and **strict qualification** engine for DLX\nDesigns — a luxury bespoke traditional menswear brand targeting high-net-worth\nclients, grooms and corporate executives in Lagos & Abeokuta, Nigeria.\n\nIt ingests real inbound traffic, filters out low-budget seekers with strict\nsemantic rules, stores only verified high-intent leads, and renders them as\nscored lead cards in a live dashboard.\n\n> **Live dashboard:** [Try the app](url:index.ts)\n> **Ingest endpoint:** `POST /api/ingest`\n\n## Architecture\n\n```mermaid\ngraph LR\n Inbound[\"Web form / corridor
(blog, IG, ads)\"] -->|\"POST /api/ingest\"| Qual[\"Qualifier
backend/worker/qualifier.ts\"]\n Qual -->|\"hard reject\"| X[\"Low budget → dropped
never stored\"]\n Qual -->|\"optional\"| LLM[\"AI refine
(free tier, optional)\"]\n Qual -->|\"pass ≥ 50\"| Store[\"SQLite store
lib/store.ts\"]\n Store -->|\"optional mirror\"| Supabase[\"Supabase
dlx_verified_leads\"]\n Store -->|\"GET /api/leads\"| UI[\"React dashboard
frontend/\"]\n```\n\n- **Dashboard:** client-side React + Hono backend (App Router-equivalent), Twind/Tailwind styling.\n- **Database:** val-scoped PostgreSQL-compatible SQLite. **Supabase mirror optional.**\n- **Qualifier:** deterministic heuristic (zero-config) + optional free-tier AI refinement.\n\n## The strict qualification engine\n\nRuns in `backend/worker/qualifier.ts` and never fabricates data.\n\n**Layer 1 — hard disqualifiers (instant reject):** `cheap`, `affordable`,\n`under 20k`/`20k`, `discount`, `thrift`, `okirika`.\n\n**Layer 2 — scoring matrix (0–100):** baseline 25, high-tier signals add points —\n`bespoke` +18, `groom`/`chieftaincy` +20, `cashmere` +15, `wedding` +14,\n`3-piece` +12, `executive` +14, `lekki`/`victoria island` +10, `lagos`/`abeokuta`\n+6, etc. **Pass threshold: ≥ 50.** Sub-threshold leads are rejected.\n\n**Layer 3 — AI refinement (optional, zero-config by default):** the engine is\n**deterministic-first** — the strict heuristic above is authoritative and needs\n**no AI key, no external call, no cost**, so no provider can ever block it. If\nyou add a free-tier key, that provider refines the score and writes a natural\nbuying signal (tried in order: `GEMINI_API_KEY`, `GROQ_API_KEY`, `OPENAI_API_KEY`).\nA provider failing just falls back to the heuristic — never an error.\n\n### Endpoints\n\n| Method | Path | Purpose |\n| --- | --- | --- |\n| `GET` | `/` | Dashboard |\n| `GET` | `/dashboard` | Dashboard (alias) |\n| `GET` | `/api/leads` | Verified leads (JSON, strongest first) |\n| `POST` | `/api/ingest` | Ingest & qualify an inbound lead — 201 on pass, 422 on reject |\n| `POST` | `/api/leads/:id/status` | Advance pipeline stage (or set one) — records history |\n| `GET` | `/api/analytics` | Pipeline / source / signal analytics (the learn layer) |\n\n`POST /api/ingest` request body:\n\n```json\n{\n \"name\": \"Oluwatosin Adeyemi\",\n \"gmail\": \"tosin@example.com\",\n \"source\": \"nigerianmenswear.com\",\n \"message\": \"I need a bespoke 3-piece groom suit for my chieftaincy ceremony in Abeokuta\"\n}\n```\n\nOnly passing leads persist. Rejected and duplicate leads are returned (422) and\nnever stored.\n\n## The growth engine loop\n\nA verified lead is more than a row — it is a story with evidence:\n\n1. **Hunt** — `cron/hunt.ts` polls a real configured source (`DLX_HUNT_URL`)\n and feeds genuinely captured inquiries through the qualifier. It never\n invents people or signals; rows without evidence are ignored.\n2. **Verify** — every lead records where it came from (`source`, `source_url`),\n exactly what was said (`evidence`), and when (`created_at`).\n3. **Qualify** — strict scoring (0–100); only ≥ 50 passes.\n4. **Prioritize** — the dashboard sorts strongest first and shows live pipeline counts.\n5. **Recommend** — each lead carries a `action`, chosen from the actual signal:\n book consultation, contact to confirm budget, or nurture.\n6. **Track** — leads move through `new → qualified → contacted → responded →\n consultation → quoted → deposit_paid → ordered → won/lost`. Every transition\n is recorded in `history`.\n7. **Learn** — `/api/analytics` reports conversion by stage and top sources and\n signals that actually produce qualified opportunities.\n\n## Capture & feed real inquiries (get it live today)\n\n**Option A — website ingestion.** A ready, branded enquiry form is hosted at\n`/capture` (or embedded by iframing it). It posts each submission to\n`/api/ingest`, which qualifies and stores it. Direct API for a custom site:\n\n```http\nPOST https://dlx-leads.val.run/api/ingest\nContent-Type: application/json\n\n{ \"name\": \"…\", \"gmail\": \"…\", \"phone\": \"…\", \"message\": \"…\", \"source\": \"…\", \"source_url\": \"…\" }\n```\n\n**Option C — JSON / Google Sheet feed (autonomous, scheduled every 15 min).**\nThe hunt poller accepts a **published Google Sheet CSV** directly, no code:\n\n1. In your sheet, make row 1 a header that includes `gmail` (plus optional\n `name`, `phone`, `message`, `source`, `source_url`).\n2. **File → Share → Publish to web →** choose the sheet → format **CSV** → copy the link.\n3. Set that link as `DLX_HUNT_URL` (and `DLX_HUNT_TOKEN` if it's private/behind auth).\n\nEach run, the engine ingests every new row, qualifies it, and skips duplicates.\nRows without an email are ignored — nothing is invented.\n\n**Option B — email intake (live inbound hunting).** Forward any organic inquiry\n(DM, WhatsApp, web message, marketplace lead) to the engine's email address and\nit is qualified, evidence-tagged, and tracked automatically:\n\n```\ndlxdesigns-e7b272d2a81611f19be51607ee4eb77e@valtown.email\n```\n\nSee [`docs/growth-corridors.md`](docs/growth-corridors.md) for the **50-verified\ngrowth corridors** (marketplaces, fashion platforms, directories, fashion-week\nhubs, forums, and press) — each mapped to an acquisition, observation, or\npartnership role the engine can consume.\n\n## Connect Instagram (real DM/comment capture)\n\nThe engine side is built and tested. To connect Meta (one-time, your login):\n\n1. Create a **Meta for Developers app** (https://developers.facebook.com).\n2. Add the **Instagram product** and connect your **Instagram Business account**.\n3. Create a token with the `instagram_business_basic`, `instagram_business_manage_messages`,\n and `pages_messaging` permissions (a **long-lived User or Page token**).\n4. Set these on the val:\n 👉 Add INSTAGRAM_VERIFY_TOKEN here: https://www.val.town/x/dlxdesigns/dlx-lead-engine/environment-variables?key=INSTAGRAM_VERIFY_TOKEN\n 👉 Add META_APP_SECRET here: https://www.val.town/x/dlxdesigns/dlx-lead-engine/environment-variables?key=META_APP_SECRET\n5. In **Meta → Developer App → Webhooks**, subscribe the **Instagram** object to\n the callback URL:\n `https://dlx-leads.val.run/api/instagram/webhook`\n using your **INSTAGRAM_VERIFY_TOKEN** as the verify token.\n\nReal DMs/comments then push into the engine automatically. Because Instagram\nDMs carry no email, each becomes a **signal** (`/api/signals`); reply to capture\nthe email, then promote it to a verified lead with\n`POST /api/signals/:id/promote`.\n\n## Google Business Profile (real local-channel capture)\n\nReviews, Q&A, and \"do you make…\" messages on your Google Business Profile are\nhigh-intent local signals. Capture them in one call — they become scored\nprospects source-tagged `google-business-profile` in the Command Center, ready\nto draft and convert:\n\n```http\nPOST https://dlx-leads.val.run/api/gbp\nContent-Type: application/json\n\n{ \"reviewer\": \"Adaeze Okafor\", \"message\": \"Do you make bespoke 3-piece groom suits for Lagos weddings?\", \"email\": \"…\", \"phone\": \"…\", \"permalink\": \"https://maps.google.com/…\" }\n```\n\nManual route (no credentials): a VA or owner copies each new review/Q&A/message\nand posts it to `/api/gbp` (or the dashboard capture form with\n`source: google-business-profile`), and the automaton takes it from there.\nAutomated pull of your GBP inbox requires Google OAuth on your account — that\npart is yours to connect when ready; everything after capture is handled here.\n\n## Configuration (environment variables)\n\nEverything runs out of the box with **zero environment variables**. The\nqualification engine is fully deterministic. The following optional keys unlock\nthe AI refinement layer (free tiers are preferred — none require billing) and\nthe Supabase mirror:\n\n- **`GEMINI_API_KEY`** — free tier (Google AI Studio key, no card required). Recommended.\n- **`GROQ_API_KEY`** — free tier. Ignored unless Gemini is absent or fails.\n- **`OPENAI_API_KEY`** — requires active OpenAI billing; only used as a last resort.\n- **`SUPABASE_URL`** + **`SUPABASE_SERVICE_ROLE_KEY`** — mirror verified leads to\n your Supabase `dlx_verified_leads` table (native SQLite store stays authoritative).\n- **`DLX_HUNT_URL`** — JSON **or published-CSV** feed the hunt poller watches\n for genuine inquiries (JSON: `{ \"leads\": [ { name, gmail, phone, message, source, source_url } ] }`).\n- **`DLX_HUNT_TOKEN`** — optional bearer token sent to the hunt source (`Authorization: Bearer …`).\n- **`INSTAGRAM_VERIFY_TOKEN`** — random string you invent; Meta must echo it on webhook verification.\n- **`META_APP_SECRET`** — optional; enables `X-Hub-Signature-256` verification on Instagram webhooks.\n- **`DLX_BRAND_NAME`** — whitelabel brand shown in capture copy + drafts (default: `DLX Designs`).\n- **`ENABLE_AUTOSEND`** — set to `1` to let the nurture automaton actually email first touches; OFF (dry-run) by default.\n\n👉 Add GEMINI_API_KEY here: https://www.val.town/x/dlxdesigns/dlx-lead-engine/environment-variables?key=GEMINI_API_KEY\n👉 Add GROQ_API_KEY here: https://www.val.town/x/dlxdesigns/dlx-lead-engine/environment-variables?key=GROQ_API_KEY\n👉 Add OPENAI_API_KEY here: https://www.val.town/x/dlxdesigns/dlx-lead-engine/environment-variables?key=OPENAI_API_KEY\n👉 Add SUPABASE_URL here: https://www.val.town/x/dlxdesigns/dlx-lead-engine/environment-variables?key=SUPABASE_URL\n👉 Add SUPABASE_SERVICE_ROLE_KEY here: https://www.val.town/x/dlxdesigns/dlx-lead-engine/environment-variables?key=SUPABASE_SERVICE_ROLE_KEY\n👉 Add DLX_HUNT_URL here: https://www.val.town/x/dlxdesigns/dlx-lead-engine/environment-variables?key=DLX_HUNT_URL\n👉 Add DLX_HUNT_TOKEN here: https://www.val.town/x/dlxdesigns/dlx-lead-engine/environment-variables?key=DLX_HUNT_TOKEN\n👉 Add INSTAGRAM_VERIFY_TOKEN here: https://www.val.town/x/dlxdesigns/dlx-lead-engine/environment-variables?key=INSTAGRAM_VERIFY_TOKEN\n👉 Add META_APP_SECRET here: https://www.val.town/x/dlxdesigns/dlx-lead-engine/environment-variables?key=META_APP_SECRET\n\n### Supabase setup (optional)\n\nCreate the mirror table by running [`database/schema.sql`](database/schema.sql)\nin the Supabase SQL editor. The table uses `gen_random_uuid()` ids, enforces a\n`score BETWEEN 0 AND 100` check, has a `gmail UNIQUE` constraint, and enables\nRow-Level Security (locked to service-role access by default). The val writes\nvia PostgREST with the service-role key and `resolution=merge-duplicates`.\n\n## File structure\n\n```\ndatabase/\n schema.sql ← Supabase/PostgreSQL schema (mirror table)\nbackend/\n config.ts ← whitelabel brand + runtime config\n pipeline.ts ← sales pipeline stages + next-stage logic\n hunt.ts ← autonomous ingestion from a real configured source\n outbound.ts ← prospect queue: score, auto-draft, guarded send, convert\n instagram.ts ← Meta webhook receiver for real IG DMs/comments\n worker/\n qualifier.ts ← strict qualification engine (disqualifiers + scoring)\n ingest.ts ← ingest worker (bridge inbound → store)\n llm.ts ← optional AI adapter (free tier Gemini / Groq / OpenAI)\ncron/\n hunt.ts ← scheduled hunt poller (every 15 min)\n automate.ts ← nurture automaton: nudge hot leads + auto-send (guarded)\nemail/\n lead-intake.ts ← email-triggered lead intake (forward inquiries here)\ndocs/\n growth-corridors.md ← 50 acquisition/observation/partnership corridors\n operating-model.md ← how the automaton runs + per-client deployment model\nlib/\n store.ts ← SQLite persistence + Supabase mirror + pipeline + analytics\nfrontend/\n components/App.tsx ← dashboard layout + empty state + pipeline strip\n components/LeadCard.tsx ← verified-lead card with evidence, action & stage\n components/LeadForm.tsx ← inline lead-capture form\nscripts/\n selftest.ts ← end-to-end qualifier + store self-test\nindex.ts ← Hono HTTP backend (dashboard + /api/*)\n```\n\n## Integrity guarantees\n\n- **No hardcoded, fake, or mock contacts anywhere.** Every record comes from a\n real `POST /api/ingest` submission that passed strict qualification.\n- Empty store → dashboard shows *“Awaiting live inbound high-intent signals…”*,\n never fake cards.\n- Duplicate emails are rejected (UNIQUE), budget seekers are dropped, sub-50\n intent is dropped.\n\n## Running the self-test\n\n`scripts/selftest.ts` exercises the full pipeline with synthetic example inputs\n(high-intent pass, low-budget reject, no-signal reject, duplicate reject) and is\nsafe to run repeatedly.\n",[],[230],"a130fa68-e89b-4e79-b351-ae119f51052e","CHANGELOG.md","01a06811-df40-730d-85ee-12df63d9ba38",["D",1788452396724],"# Changelog\n\n## 2026-07-30 — Immutable asset caching\n\nFrontend files are now served at version-addressed URLs\n(`/__immutable/45/frontend/index.tsx`) with\n`Cache-Control: public, max-age=31536000, immutable`, so repeat visits load the\nwhole client graph from the browser cache — roughly 3× faster (~665ms → ~157ms\nmeasured). Publishing your val bumps its version, which changes every URL, so\ncaches invalidate automatically. Old-version URLs return 404 after a publish\n(like Next.js build assets); a reload picks up the new version.\n\nWhat changed in the template:\n\n- `frontend/index.html` → [`frontend/root.tsx`](/frontend/root.tsx): the HTML\n shell is now JSX and stamps asset URLs with `immutableFileUrl()`\n- [`index.ts`](/index.ts): serves `Root()` at `/`, and one\n `app.get(\"/__immutable/*\", (c) => serveImmutableFile(c.req.path))` route\n serves all frontend files\n\n### Upgrading an existing remix\n\nYour copy of this template doesn't update automatically. Two options:\n\n**Minimal (most of the benefit):** point both routes at `serveImmutableFile` —\nyour existing bare URLs redirect into versioned space, the new route serves\nthem, and the whole module graph gets cached (costs one redirect per page view):\n\n```ts\nimport { serveImmutableFile } from \"https://esm.town/v/std/utils/index.ts\";\n\napp.get(\"/__immutable/*\", (c) => serveImmutableFile(c.req.path));\napp.get(\"/frontend/**/*\", (c) => serveImmutableFile(c.req.path)); // was serveFile\n```\n\n**Full upgrade (also removes the redirect):** three self-contained steps —\nno other files needed. Adjust the ``, favicon, and body of `Root()` to\nmatch your app's existing `index.html`, and stamp anything else your shell\nreferences directly (images, css) with `immutableFileUrl()`.\n\n1. Create `frontend/root.tsx`:\n\n```tsx\n/** @jsxImportSource npm:hono@4/jsx */\nimport { raw } from \"npm:hono@4/html\";\nimport { immutableFileUrl } from \"https://esm.town/v/std/utils/index.ts\";\n\n// The HTML shell for the app. It is never cached, so immutableFileUrl can stamp\n// the current val version into each asset URL — the browser caches those\n// immutably, and publishing the val changes the URLs, refetching exactly once.\nexport function Root() {\n return (\n <>\n {raw(\"<!DOCTYPE html>\")}\n <html lang=\"en\">\n <head>\n <meta charSet=\"UTF-8\" />\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" />\n <title>React Hono Val Town Starter\n

History · capture.html