Skip to content

MIGRATION.md

Latest commit

 

History

History
89 lines (72 loc) · 2.4 KB

MIGRATION.md

File metadata and controls

89 lines (72 loc) · 2.4 KB

Migration Complete! 🎉

Your project has been successfully ported from a separate frontend/backend architecture to a unified Next.js application.

What Changed

Old Structure (Removed)

  • ❌ backend/ folder with Express.js server
  • ❌ frontend/ folder with Create React App
  • ❌ Separate frontend and backend servers

New Structure (Added)

  • ✅ app/ directory with Next.js App Router
  • ✅ app/api/ for backend API routes
  • ✅ app/components/ for React components
  • ✅ lib/ for utility functions (scraper, relationships)
  • ✅ Single unified application

Next Steps

1. Clean Up Old Files (Optional)

You can now safely delete the old directories:

Remove-Item -Recurse -Force backend
Remove-Item -Recurse -Force frontend

2. Set Up Environment Variables

Create a .env.local file in the root directory:

MONGODB_PASSWORD=your_actual_password_here

3. Install Dependencies

npm install

4. Run the Development Server

npm run dev

Then open http://localhost:3000 in your browser.

Key Improvements

  1. Unified Codebase: No more switching between frontend and backend
  2. Single Server: Only one port (3000) instead of two (3000 + 3030)
  3. API Routes: Built-in Next.js API routes replace Express
  4. Better Performance: Next.js optimizations and React 18 features
  5. Simpler Deployment: One application to deploy instead of two

File Structure

course-map/
├── app/
│   ├── api/
│   │   ├── coursedata/route.js    # GET /api/coursedata
│   │   └── selection/route.js     # POST /api/selection
│   ├── components/
│   │   ├── CourseList.js
│   │   ├── Graph.js
│   │   └── Panel.js
│   ├── globals.css
│   ├── layout.js
│   └── page.js
├── lib/
│   ├── relationships.js
│   └── scraper.js
├── public/
│   └── robots.txt
├── .env.local (create this)
├── .env.example
├── jsconfig.json
├── next.config.js
├── package.json
└── README.md

Important Notes

  • MongoDB password is now read from environment variables
  • API endpoints changed from http://localhost:3030/coursedata to /api/coursedata
  • All components use 'use client' directive for client-side interactivity
  • The scraper and relationships logic remain unchanged

Enjoy your new Next.js application! 🚀