BookSwap

Description

BookSwap is a book-sharing web app written in Python with Django. You list the books you own, browse or search what everyone else has put up, and request to borrow something you want. When two people agree on a swap, a simple courier flow helps them arrange the hand-off.

It started life as our entry for the Student Start-up and Innovation Policy (SSIP) national hackathon. I've kept it around since as a portfolio piece.

Tech Used

Prerequisites

You'll want Python 3 and pip, Git, and SQLite 3 installed before you start.

Getting Started

Clone the repo and hop into the directory:

git clone https://github.com/default-cybe/BookSwap.git
cd BookSwap

Set up a virtual environment and activate it:

python -m venv venv
source venv/bin/activate      # on Windows: venv\Scripts\activate

Install the dependencies:

pip install -r requirements.txt

Copy the example env file and tweak the values for your setup:

cp .env.example .env

At the very least you'll need to set DJANGO_SECRET_KEY in .env. Django can generate one for you:

python -c "from django.core.management.utils import get_random_secret_key; print(get_random_secret_key())"

Run the migrations and start the dev server:

python manage.py migrate
python manage.py runserver

That's it. The app should be up at http://127.0.0.1:8000/.