Minimalist yet feature rich contact manager web application using Django + Tailwind CSS.
The project can run either with Docker (PostgreSQL) or directly on your machine using the built-in SQLite database. A blank .env file is included; update the values for your environment—especially the database settings—when running with PostgreSQL.
- Create a virtual environment:
python -m venv venv - Activate the virtual environment:
- macOS/Linux:
source venv/bin/activate - Windows (Command Prompt):
venv\Scripts\activate.bat - Windows (PowerShell):
venv\Scripts\Activate.ps1
- macOS/Linux:
- Install dependencies:
pip install -r requirements.txt - Run database migrations:
python manage.py migrate - Start the development server:
python manage.py runserver - Visit
http://127.0.0.1:8000
Leaving DB_NAME blank in .env tells Django to fall back to SQLite automatically.
- Update
.envwith the PostgreSQL credentials for your environment. - Start the services:
docker compose up --build - Apply migrations:
docker compose exec web python manage.py migrate - Visit
http://localhost:8000
- Custom User model (with email login)
- Session Timeout
- Pagination
If you like this project, make sure to give it a star and share with your friends.
This work is licensed under a Creative Commons Attribution 4.0 International License.
