LumberNow

SaaS-templated storefront for lumber and building materials dealers. Built on the Velocity tech stack.

Architecture

Layer	Technology
Frontend	Lit 3 (Web Components), Vite 6, TypeScript, Vanilla CSS
Backend	Go (stdlib net/http), PostgreSQL 16 (pgx/v5)
Auth	JWT, multi-tenant (X-Tenant-ID)

Monorepo Structure

• frontend/ — Lit 3 customer portal + dealer admin portal
• backend/ — Go API server with product catalog, auth, and storefront config

Getting Started

Prerequisites

• Node.js >= 20
• Go >= 1.25
• Docker + Docker Compose

Local Development

# Start backend stack (API + Postgres; control-plane + per-tenant DBs auto-seeded)
cd backend
docker compose up --build

# Start frontend dev server (in another terminal)
cd frontend
npm install
npm run dev

The frontend dev server proxies /api/v1 to the backend at localhost:8080.

Demo Tenant

B&B Lumber — demo credentials are seeded automatically via docker compose up.

Role	Email	Password
Dealer admin	admin@bblumber.com	admin
Contractor	chris@chriscustomdecks.com	demo