yasen-ab/wasla

Purpose and entry points

This is a Vite/React TypeScript application for publishing client quote/proposal pages and managing them through an authenticated admin interface. Browser startup flows from index.html to src/main.tsx, which renders src/App.tsx.

Application composition and routing

src/App.tsx is the top-level route selector. It separates the public quote experience from the admin area, while src/components/admin/router.ts defines admin-side navigation/state. The main UI boundaries are:

• Public quote rendering: src/components/public/PublicQuotePage.tsx

• Admin shell/navigation: src/components/admin/AdminShell.tsx

• Admin authentication gate: src/components/admin/LoginScreen.tsx

Public quote delivery flow

A public route resolves a quote identifier, loads its quote data, and renders a client-facing proposal page in src/components/public/PublicQuotePage.tsx. Formatting and domain type contracts are centralized in src/lib/format.ts and src/lib/types.ts; data access is mediated through src/lib/data.ts, rather than embedded directly in page components.

Admin quote management flow

Authenticated users operate inside src/components/admin/AdminShell.tsx. Quote lifecycle management is split between:

• Quote list, selection, and status-oriented operations: src/components/admin/QuotesList.tsx

• Quote creation/editing: src/components/admin/QuoteEditor.tsx

• Reusable asset/library management: src/components/admin/LibraryPage.tsx

This keeps editing, list management, and reusable content/library concerns as distinct admin stages.

Data, authentication, and persistence boundary

src/lib/supabase.ts is the external backend client boundary. src/lib/auth.tsx owns authentication/session state used by the admin experience. src/lib/data.ts provides application-facing data operations and can isolate UI code from Supabase-specific queries. src/lib/mockData.ts indicates local/sample data support, likely for development or fallback UI states.

Database structure is provisioned through Supabase migration supabase/migrations/20260804081621_create_quotes_schema.sql, making Supabase/Postgres the material persistence infrastructure for quotes and related records.

Shared domain and interface layer

src/lib/types.ts defines shared models across admin editing, persistence, and public rendering. Shared UI primitives in src/components/ui/Button.tsx, src/components/ui/Modal.tsx, and src/components/ui/ImageUploader.tsx support consistent actions, dialogs, and media input without coupling domain pages to presentation mechanics.

Runtime and build infrastructure

The client is a React application bundled and served by Vite (vite.config.ts), with TypeScript project configuration in tsconfig.json. Styling is based on Tailwind/PostCSS (tailwind.config.js, postcss.config.js) plus application styles in src/index.css. Supabase is the primary external service for authentication and database-backed quote data.