Pawsitive
Pawsitive is a small Django-based web project for pet adoption and related pages. This repository contains the Django app code, templates, static assets, and example blog pages.
Project layout
pawsitive/ - Django project module (settings, wsgi, urls, asgi)
pawsitive/adoptions/ - Django app for adoptions (models, views, templates, static files)
blog/ - static blog pages and templates
intlTelInput/ - third-party JS/CSS for phone input
pawsitive/media/ - user-uploaded files and pet photos (example subfolders included)
db.sqlite3 - SQLite database (example/testing)
Requirements
- Python 3.8+ (3.10+ recommended)
- pip
- A virtual environment tool (venv, virtualenv, or similar)
Setup (development)
- Create and activate a virtual environment (Windows PowerShell):
python -m venv .venv; .\.venv\Scripts\Activate.ps1
- Install dependencies. If a
requirements.txt exists at the repo root, run:
pip install -r requirements.txt
If there's no requirements.txt, install Django at minimum:
pip install django
- Apply migrations and create a superuser (optional):
python pawsitive/manage.py migrate
python pawsitive/manage.py createsuperuser
- Run the development server:
python pawsitive/manage.py runserver
- Open your browser at
http://127.0.0.1:8000/.
Static and media files
- Static files for the
adoptions app live under pawsitive/adoptions/static/adoptions/.
- Media uploads are stored in
pawsitive/media/ (check pawsitive/settings.py for MEDIA_ROOT/MEDIA_URL).
If static files are not served automatically in development, run:
python pawsitive/manage.py collectstatic
Notes
- This repository contains an example SQLite database
db.sqlite3. Remove it and rerun migrations for a fresh DB.
- The
intlTelInput folder contains an included phone input library used by the forms.
- Templates for adoption forms are under
pawsitive/adoptions/templates/adoptions/.
Testing
Run tests (if present) with:
python pawsitive/manage.py test