KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #dsh #dsh-plugin #ai-agent #claude-code #codex #typescript #ai-agents #mcp #cli #rust #deepseek-harness

pennplanner

★ 16 Open GitHub ↗

🎓 Drag-and-drop degree planner for the online MCIT, MSE-DS, and MSE-AI programs at University of Pennsylvania / Penn Engineering

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

> [!WARNING]
> This repository has been archived. The PennPlanner no longer receives any updates starting May 1, 2024, as the University of Pennsylvnia plans to roll out DegreeWorks, a degree-planning tool, in the Fall of 2024. PennPlanner will remain accessible [here](https://pennplanner.vercel.app/), and anyone is welcome to fork and use this codebase for their needs.

<div align="center">
  <a href="https://github.com/qu8n/PennPlanner">
    <img src="public/logo.png" alt="PennPlanner logo" height="50" width="50">
  </a>
  <h1 align="center">PennPlanner</h1>

<p align="center">
    A drag-and-drop course planner for students in the online Master of Computer and Information Technology (MCIT) and Master of Science in Engineering in Data Science (MSE-DS) at the University of Pennsylvania.
    <br />
    <a href="https://www.pennplanner.com/">Website</a>
    ·
    <a href="https://github.com/qu8n/pennplanner/issues/new?assignees=&labels=&projects=&template=bug_report.md&title=">Report Issues</a>
    ·
    <a href="https://github.com/qu8n/pennplanner/discussions/new?category=q-a">Ask Questions</a>
    ·
    <a href="https://github.com/qu8n/PennPlanner/discussions/new?category=feature-ideas">Suggest Features</a>
  </p>
</div>

## Features

- Drag and drop courses to plan your entire degree journey
- View full details of each course, including ratings from [MCIT Central](https://mcitcentral.com/)
- View, filter, sort, and search the entire Penn Engineering Online course catalog
- Receive warnings for missing prerequisites or other requirements in your planner

## Built with

- Typescript
- React
- Tailwind CSS
- Next.js
- Vercel Deployment
- Supabase Auth with Google OAuth
- Supabase's PostgreSQL database
- Highlight.io for observability

## Getting started

### Prerequisites

- Node.js
- NPM
- Supabase account

### Running locally

1. Clone the repo

```sh
git clone
```

2. Install NPM packages

```sh
npm install
```

3. Create a `.env.local` file in the root directory and add the following environment variables:

```sh
NEXT_PUBLIC_SUPABASE_URL=
NEXT_PUBLIC_SUPABASE_ANON_KEY=
```

Note that for UI-only development, you might be able to opt out of using a database completely by commenting out all Supabase-related code.

4. Remove observability code

a. Delete `instrumentation.ts`

b. Remove `HighlightInit` from `_app.tsx`

c. Replace `next.config.js` with the default config:

```js
/** @type {import('next').NextConfig} */
const nextConfig = {
  reactStrictMode: true,
}

module.exports = nextConfig
```

4. Run the development server

```sh
npm run dev
```

### Supabase's PostgreSQL database schema

`users` table:
| Name | Data Type | Format |
| -------------- | ------------------------ | ------------ |
| id | uuid | uuid |
| created_at | timestamp with time zone | timestamptz |
| username | text | text |
| full_name | text | text |
| first_year | smallint | int2 |
| program | text | text |
| waived_courses | ARRAY | \_text |

`semesters` table:
| Name | Data Type | Format |
| ------------------ | ------------------------ | ------------ |
| id | bigint | int8 |
| created_at | timestamp with time zone | timestamptz |
| semester_index | smallint | int2 |
| semester_course_ids| ARRAY | \_text |
| user_id | uuid | uuid |

Schema visualizer:

## Contributing

Contributions are welcome! Feel free to open a pull request or submit an issue. If you need help getting started, please contact me on Slack [here](https://penn-eng-onl-students.slack.com/team/U029YJF17LG).

pennplanner

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README