Queue-North-Website/PROJECT.md

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