Campus Compass Portfolio

Campus Compass is a CPT208 campus-tour portfolio rebuilt with React, Vite, TypeScript, and Tailwind CSS.

Tech Stack

• React 19
• Vite 8
• TypeScript
• Tailwind CSS (v4 via @tailwindcss/vite)

Project Scripts

• npm run dev start local development server
• npm run build create production build into dist/
• npm run preview preview production build locally

Local Development

1. Install dependencies

   npm install

2. Start development

   npm run dev

3. Build for production

   npm run build

GitHub Pages Deployment

The repository includes .github/workflows/deploy.yml, which deploys automatically on push to main.

One-time repository settings

1. Open GitHub repository Settings.
2. Go to Pages.
3. Set Build and deployment source to GitHub Actions.

After that, every push to main will:

1. Install dependencies (npm ci)
2. Build the project (npm run build)
3. Deploy dist/ to GitHub Pages

Notes

• vite.config.ts currently uses base: '/', which matches user/org pages such as group3b-5.github.io.
• If this project is moved to a project page repository, update base accordingly, for example base: '/repo-name/'.