70 lines
2.6 KiB
Markdown
70 lines
2.6 KiB
Markdown
|
# Queue North Website
|
||
|
|
|
||
|
|
## Overview
|
||
|
|
Project: Queue-North-Website
|
||
|
|
Created: 2026-05-11
|
||
|
|
Status: Active (Phase 1 Complete - 0.1.0)
|
||
|
|
Rebuild Phase: 1 (Vite + React + Express + SQLite)
|
||
|
|
|
||
|
|
## Description
|
||
|
|
Website for Queue North Technologies — an 8x8 Certified Partner delivering UCaaS, Contact Center, deployment, and managed lifecycle support for SMB and enterprise organizations.
|
||
|
|
|
||
|
|
## Tech Stack (Phase 1)
|
||
|
|
- **Vite** — build tool and dev server
|
||
|
|
- **React 19** — SPA with client-side routing via React Router 7
|
||
|
|
- **Tailwind CSS** — utility-first styling with custom theme
|
||
|
|
- **shadcn/ui-style** — component primitives built in
|
||
|
|
- **Sonner** — toast notifications
|
||
|
|
- **TanStack Query** — server state management
|
||
|
|
- **Express** — backend API server
|
||
|
|
- **better-sqlite3** — local SQLite database
|
||
|
|
|
||
|
|
## Directory Structure (Phase 1)
|
||
|
|
- `index.html` — Entry point (Vite + React entry)
|
||
|
|
- `src/main.jsx` — React entry point with QueryClient and Toaster
|
||
|
|
- `src/App.jsx` — Layout wrapper with Header, MobileNav, Footer
|
||
|
|
- `src/router.jsx` — React Router configuration
|
||
|
|
- `src/lib/api.js` — API helper with TanStack Query
|
||
|
|
- `src/data/services.js` — Services data
|
||
|
|
- `src/data/industries.js` — Industries data
|
||
|
|
- `src/components/ui/` — UI primitives (Button, Card, Input, etc.)
|
||
|
|
- `src/components/layout/` — Header, Footer, MobileNav
|
||
|
|
- `src/pages/` — Route pages (Home, About, Services, etc.)
|
||
|
|
- `server/index.js` — Express backend with SQLite
|
||
|
|
- `db/queuenorth.db` — SQLite database (created on first run)
|
||
|
|
- `assets/` — Images, icons, logos
|
||
|
|
|
||
|
|
## Git
|
||
|
|
- **Branch:** `dev` (working), `main` (stable)
|
||
|
|
- **Remote:** `ssh://forgejo/null/Queue-North-Website.git`
|
||
|
|
|
||
|
|
## Versioning
|
||
|
|
|
||
|
|
Version numbers must correlate to the active overhaul phase.
|
||
|
|
|
||
|
|
- Phase 1 releases use `0.1.x`
|
||
|
|
- Phase 1 baseline: `0.1.0`
|
||
|
|
- Phase 1 patches/iterations: `0.1.1`, `0.1.2`, etc.
|
||
|
|
- Phase 2 releases use `0.2.x`
|
||
|
|
- Phase 2 baseline: `0.2.0`
|
||
|
|
- Phase 2 patches/iterations: `0.2.1`, `0.2.2`, etc.
|
||
|
|
- Phase 3 releases use `0.3.x`
|
||
|
|
- Phase 4 releases use `0.4.x`
|
||
|
|
- Phase 5 releases use `0.5.x`
|
||
|
|
|
||
|
|
Do not use unrelated semantic version bumps during the overhaul. The minor number tracks the phase; the patch number tracks changes within that phase.
|
||
|
|
|
||
|
|
## Phase Completion Git Rule
|
||
|
|
|
||
|
|
Push to `dev` after every completed and verified phase.
|
||
|
|
|
||
|
|
- Agents do not touch git.
|
||
|
|
- Bishop verifies and updates docs.
|
||
|
|
- Ripley performs final checks, commits, and pushes to `dev`.
|
||
|
|
|
||
|
|
## Conventions
|
||
|
|
- Follow AGENTS.md for agent dispatch protocol
|
||
|
|
- Ripley coordinates, Neo codes, Scarlett styles, Bishop verifies, Hudson secures
|
||
|
|
- All agents read STRUCTURE.md before starting tasks
|
||
|
|
- Ripley owns git — no agent touches git directly
|