Imported from Atan-D-RP4/Memora (memora-frontend/src/AGENTS.md). Install upstream with npx skills add Atan-D-RP4/Memora --skill src. Copyright stays with the author.

FRONTEND SOURCE - React Application

Scope: Frontend source directory memora-frontend/src Generated: 2026-03-30

Overview

Main React application source with routing, components, and utilities.

Structure

memora-frontend/src/
├── components/          # React components (see components/AGENTS.md)
├── pages/              # Route page components (13 files)
├── routes/             # React Router configuration (5 files)
├── hooks/              # Custom React hooks
├── services/           # API service layers
├── utils/              # Utility functions
├── contexts/           # React contexts
├── assets/             # Static assets
└── main.jsx            # Application entry point

Where To Look

Conventions

• React Router v6 for navigation
• File-based routing structure
• Separation of concerns (pages vs components)
• Service layer for API calls
• Context for global state

Anti-Patterns (This Project)

• Mixed routing styles: Some routing logic scattered across components
• Service inconsistency: API calls sometimes in components directly

Notes

• Main.jsx is the application entry point with router setup
• Components directory has its own AGENTS.md for detailed component guidance
• Pages directory contains route-level components that compose components/

Commands

# Development server
bun run dev

# Lint, tests, and build
bun run lint
bun run test
bun run build

# Preview production build
bun run preview

Deployment Notes

• Frontend service layer defaults to "/api" in production (VITE_API_URL can override).
• Root vercel.json handles API routing to backend serverless entrypoint and SPA fallback to index.html.
• Build output goes to memora-frontend/dist/ (configured in vercel.json outputDirectory).
• Vite and dev dependencies must be installed with --include=dev flag for Vercel builds.