Admin

name	type	size	perms	modified	actions
[parent directory]
workflows/	dir	-	0775	2026-08-24 22:00:33
copilot-instructions.md	file	2,004 B	0664	2026-08-20 06:40:58	edit

editing: copilot-instructions.md

# GitHub Copilot Instructions - Sisterspace Ecommerce

This repository is a pnpm monorepo containing a Next.js App Router frontend (`apps/web`) and an Express/Prisma backend (`apps/api`). When suggesting code edits, completions, or refactorings, you must adhere to the following project-wide rules:

## 1. Port Assignments
- **Next.js Frontend**: `http://localhost:5001` (`npm run dev --prefix apps/web` runs on port 5001 to prevent conflicts with other local projects on ports 3000-3002).
- **Express Backend**: `http://localhost:5000` (`PORT=5000` in backend `.env`).

## 2. Dev-Mode Authentication & Role State
- The frontend holds the active role (`regular-user`, `seller-user`, `admin-user`) in client-side React `RoleContext`. This state is persisted in `localStorage` as `sisterspace_current_role`.
- Changing roles in the UI `RoleSwitcher` dropdown automatically redirects the user to their role's home dashboard page.
- All API requests initiated via Axios (`apps/web/src/lib/api-client.ts`) inject a custom header called **`x-dev-role`** (value mapped to `buyer`, `seller`, or `admin` based on the active localStorage role) when in Dev Mode.
- The backend's `authMiddleware` (`apps/api/src/middleware/auth.ts`) reads `x-dev-role` in Dev Mode to load the correct mock user context.
- **Do not introduce patchwork fixes** that manually bypass this header-injection logic. All client-side requests must stay synchronized with backend active-role contexts.

## 3. Route Layout Layouts
- `/listings/search` is wrapped in the `SearchListingsLayout` which loads the `DashboardShell`, keeping the sidebar and navbar navigation visible.
- `/listings/[id]` (product details) is a standalone page outside of the `DashboardShell`.
- Sidebar menu items always start with a default "Dashboard" link and change dynamically according to the active role state.

## 4. Verification Steps
- Verify TypeScript compilations: `npm run typecheck --prefix apps/web`
- Run Jest test suite: `npm test --prefix apps/api`

cancel