Common Funding Application

The Common Funding Application is an online application that allows student groups and organizations to request funding from various funding sources at the University of Pennsylvania.

Local Backend Setup

• Install uv
• Install mysql_config (Ubuntu: apt install libmysqlclient-dev / MacOS: brew install mysql-connector-c)
• Install python dependencies (uv sync)
• Install pre-commit (uv run pre-commit install)
• Migrate database (uv run manage.py migrate)
• Import dummy data (uv run import_demo.py)
• Run the server (uv run manage.py runserver)
• Navigate to the app
• Example login credentials: philo / philo for requester, spectrum / spectrum for funder

Front-End Setup

• Install Bun
• Install Mocha (bun install -g mocha)
• Run tests (mocha app/static/test/)

DB migrations

• Edit models.py
• uv run manage.py makemigrations
• uv run manage.py migrate

Environment Variables

In development, you do not need to add any environment variables. However, in production, there are a few that need to be set:

DEBUG=False
SENDGRID_USERNAME=pennlabs
SENDGRID_PASSWORD
SECRET_KEY
DATABASE_URL

Contributors

• The development team at Penn Labs