Skip to content

A full-stack Flask application that connects event organizers and companies looking to sponsor events.

Notifications You must be signed in to change notification settings

EricMontague/SponsorMatch

Repository files navigation

SponsorMatch

SponsorMatch is a Flask application that connects event organizers with companies who are looking to sponsor events.

code-coverage last-commit


Image of Homepage


After reading Miguel Grinberg's Flask: Web Development, I wanted to build off of the concepts from his book and build my own Flask application. While looking for ideas, I stumbled upon an old post on Quora where the founder of Eventbrite mentioned how it can be difficult for event organizers to find sponsors for their events. This inspired me to build, [SponsorMatch](https://sponsormatch.herokuapp.com/), a web application dedicated to solving this problem.

Using the live application:

  • If you're using the live application and you choose to register as a sponsor, use 4242 4242 4242 4242 as the credit card number when purchasing packages as this is one of Stripe's test credit card numbers. The rest of the purchase form can be filled in with whatever numbers you wish to complete your purchase.

Development:


Running with Docker

➜ git clone https://github.com/EricMontague/SponsorMatch.git
➜ cd Sponsormatch
➜ touch .docker-env (add environment variables here)
➜ docker-compose up

.docker-env

FLASK_APP=sponsormatch.py
FLASK_CONFIG=docker
MAIL_USERNAME=(optional) - Use if you want to utilize email functionality
MAIL_PASSWORD=(optional) - Use if you want to utilize email functionality
ADMIN_EMAIL=(optional)
SECRET_KEY=
STRIPE_PUBLISHABLE_KEY=
STRIPE_SECRET_KEY=
DATABASE_URL= postgresql://sponsormatch:password@database:5432/sponsormatch_db
POSTGRES_USER=sponsormatch
POSTGRES_PASSWORD=password
POSTGRES_DB=sponsormatch_db
ELASTICSEARCH_URL=http://elasticsearch:9200 

Running with the Werkzeug development server

  • Open a tab in your terminal, navigate to the directory that contains Elasticsearch and run elasticsearch-7.6.0/bin/elasticsearch in order to start up Elasticsearch
  • Then, in a new tab, sequentially enter the commands below
➜ git clone https://github.com/EricMontague/SponsorMatch.git
➜ cd Sponsormatch
➜ python3 -m venv venv
➜ source venv/bin/activate
➜ pip install --upgrade pip && pip install -r requirements.txt
➜ touch .env (add environment variables here)
➜ flask setup-environment --fake-data (optional flag if you want to insert fake data into the database)
➜ flask run

.env

FLASK_APP=sponsormatch.py
FLASK_ENV=development
FLASK_DEBUG=1
MAIL_USERNAME=(optional) - Use if you want to utilize email functionality
MAIL_PASSWORD=(optional) - Use if you want to utilize email functionality
ADMIN_EMAIL=(optional)
SECRET_KEY=
STRIPE_PUBLISHABLE_KEY=
STRIPE_SECRET_KEY=
DATABASE_URL= (optional)
ELASTICSEARCH_URL=http://localhost:9200

Testing

➜ python run-tests.py


Core Features

  • Organizers can create events as well as sponsorship packages that can be purchased in the app by potential sponsors through the Stripe API
  • Organizers have an area where they can manage their events, make changes, and see what purchases have been made
  • Sponsors have an area where they can review past purchases
  • Sponsors can save events they're interested in to a personalized list
  • The app offers basic search functionality for finding events, powered by Elasticsearch

Technologies Used

  • Flask
  • Bootstrap
  • Elasticsearch
  • jQuery
  • Stripe API
  • SQLite/Postgresql

About

A full-stack Flask application that connects event organizers and companies looking to sponsor events.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published