Lantern — Scaffold Notes

This file describes the current scaffold and how to work with it.

Web scaffold

• Vite + React
• PWA enabled via vite-plugin-pwa (configured in vite.config.mjs)
• Tailwind CSS configured (tailwind.config.cjs, postcss.config.cjs, src/tailwind.css)
• Storybook for component development (npm run storybook)
• Vitest + Testing Library for unit tests (vitest.config.js, test.setup.js)

Key files

• Root: package.json, index.html, .gitignore
• App shell & routing: src/main.jsx, src/App.jsx (hash-based routes)
• Merchants: src/screens/merchant/MerchantDashboard.jsx, src/screens/merchant/OfferForm.jsx
• Firebase setup: src/firebase.js
• Shared helpers: src/lib/ (auth/profile services, encryption, device helpers)
• PWA: public/manifest.webmanifest, public/icons/*, vite.config.mjs
• Tests: vitest.config.js, test.setup.js, src/__tests__/
• Storybook docs: docs/storybook/*

Commands

• npm install — install dependencies
• npm run dev — run dev server (Vite)
• npm run build — production build
• npm run preview — preview built site (best for PWA testing)
• npm run storybook — run Storybook on http://localhost:6006
• npm test — run unit tests (Vitest)
• npm run lint — lint src
• npm run lint:fix — autofix lint issues
• npm run format — format source files
• npm run format:check — check formatting only
• npm run test:coverage — run tests with coverage

Mobile (next)

• Recommended: Initialize an Expo project in /mobile/ with npx create-expo-app mobile.
• Share UI logic where possible; consider monorepo structure later.

PWA (web)

• Installable behavior on supported browsers; service worker generated at build time.
• See ./PWA.md for local testing instructions.

Suggested backend approaches

• Realtime: Firebase or Supabase for quick prototypes
• Custom backend: Node.js + Express + WebSocket (or Socket.IO)