KnearMe Portfolio Overview

Purpose

apps/knearme-portfolio is the primary KnearMe product app. It powers:

• Public marketing and SEO routes.
• Contractor onboarding and dashboard experiences.
• Public portfolio/business pages.
• API routes for auth, AI interactions, SEO tools, and platform workflows.

Stack

• Framework: Next.js App Router (next@15.5.12).
• Language: TypeScript.
• Runtime/Data: Supabase Auth + Postgres + Storage.
• UI: Tailwind CSS v4 + Radix + custom UI components.
• Testing: Vitest + Playwright.
• Deployment: Vercel (frontend/API) with Cloudflare edge worker protection on selected paths.

Ownership

• Product/app ownership: Portfolio engineering.
• Docs ownership: portfolio-team.
• Canonical app docs path: /Users/aaronbaker/knearme-platform/docs/apps/knearme-portfolio.

Primary Commands

Run from repository root unless noted.

pnpm -C apps/knearme-portfolio dev
pnpm -C apps/knearme-portfolio build
pnpm -C apps/knearme-portfolio typecheck
pnpm -C apps/knearme-portfolio lint
pnpm -C apps/knearme-portfolio test:unit
pnpm -C apps/knearme-portfolio test:e2e:mock

Source References

• App README: /Users/aaronbaker/knearme-platform/apps/knearme-portfolio/README.md
• App-specific agent guide: /Users/aaronbaker/knearme-platform/apps/knearme-portfolio/AGENTS.md
• CI workflow: /Users/aaronbaker/knearme-platform/.github/workflows/ci.yml