learn-build-apps-copilot-agent/.github/instructions/octofit_tracker_setup_project.instructions.md

applyTo

applyTo
**

Octofit Tracker Multi-tier Application Setup Guidelines

Application goals

Build an Octofit Tracker multi-tier application with:

• User authentication and profiles
• Activity logging and tracking
• Team creation and management
• Competitive leaderboard
• Personalized workout suggestions

Command execution rules

• Never change directories in commands.
• Always reference target paths directly.

Forwarded ports

• 8000: public (logic/API tier)
• 5173: public (presentation tier)
• 27017: private (data tier)

Do not propose any other ports to forward or make public.

Project structure

octofit-tracker/
├── backend/
│   ├── src/
│   ├── package.json
│   └── tsconfig.json
└── frontend/
    ├── src/
    └── package.json

Stack requirements

Presentation tier

• React 19 with Vite
• react-router-dom for navigation
• bootstrap for styling

Logic tier

• Node.js (LTS)
• Express
• TypeScript

Data tier

• MongoDB (mongodb-org)
• Mongoose for data access

MongoDB service expectations

• Always use ps aux | grep mongod to check whether mongod is running.
• mongodb-org is the official MongoDB package.
• mongosh is the official client tool.
• Use Mongoose models from the logic tier for schema/data work instead of ad-hoc raw scripts.