This page explains how to set up and run the project locally for development or testing.

Before starting, make sure you have these installed:

project-management-platform/
│
├── backend/           # Express.js API
│   ├── package.json
│   ├── src/
│   └── .env
│
├── frontend/          # Vue.js or React frontend
│   ├── package.json
│   ├── src/
│   └── .env
│
└── README.md

git clone https://github.com/<your-username>/<repo-name>.git
cd <repo-name>

1. Navigate to the backend folder:

   cd backend

2. Install dependencies:

   npm install

3. Create a .env file:

   touch .env

4. Add the following environment variables:

   PORT=5000
   MONGO_URI=mongodb://localhost:27017/project_manager
   JWT_SECRET=yourSecretKey
   

5. Start the backend server:

   npm run dev

   By default, it runs on: http://localhost:5000

1. Navigate to the frontend folder:

   cd ../frontend

2. Install dependencies:

   npm install

3. Create a .env file:

   VITE_API_URL=http://localhost:5000
   

4. Start the development server:

   npm run dev

   Access your app at: http://localhost:5173

Once both servers are running:

• Open your browser and visit http://localhost:5173
• Create a new account
• Open browser console → ensure API calls to http://localhost:5000 return 200 (OK)
• MongoDB Compass should show a new database named project_manager

You can add unit or integration tests later:

# backend
cd backend
npm run test

# frontend
cd frontend
npm run test

To deploy your app:

Your local setup should now be running with:

• Frontend: http://localhost:5173
• Backend: http://localhost:5000
• Database: MongoDB local or Atlas

You’re ready to develop, test, and document your app!

Next: Go to Architecture or Sprints to start planning development.