Document frontend architecture and development patterns

[Copilot]

The frontend layer lacked documentation beyond Vite boilerplate. Added comprehensive technical documentation and practical quick-start guide.

New Documentation

docs/frontend.md (459 lines)

• Architecture: React 18 + Vite + Tailwind + React Query v3 + React Router v7
• Component structure and organization (admin/, entity/, context/)
• State management patterns (Context API for UI, React Query for server state)
• API integration with smart URL detection (Codespaces, runtime config, localhost fallback)
• Development workflow, configuration files, common patterns
• Performance, accessibility, security, and troubleshooting guidance

frontend/README.md (replaced boilerplate)

• Quick start commands and project structure
• Technology stack and key features
• Common tasks and contribution guidelines
• Links to comprehensive documentation

Documentation Structure

frontend/
├── src/
│   ├── api/config.ts          # Smart API URL detection
│   ├── components/
│   │   ├── admin/             # Admin-specific components
│   │   ├── entity/product/    # Domain entity components
│   │   └── *.tsx              # Shared components
│   └── context/               # Auth and Theme providers

Updated Cross-References

• README.md - Added frontend documentation link
• docs/architecture.md - Enhanced frontend section with tech stack details and reference to detailed docs

All documentation verified against actual codebase structure, dependencies (React Query v3.39.3), and build configuration.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• tanstack.com
  • Triggering command: /usr/bin/curl curl -s -o /dev/null -w %{http_code} REDACTED (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Original prompt

document frontend layer

The user has attached the following file paths as relevant context:

• .github\copilot-instructions.md

Created from VS Code.

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.