Skip to content

Latest commit

Β 

History

History
113 lines (55 loc) Β· 1.93 KB

File metadata and controls

113 lines (55 loc) Β· 1.93 KB

BillVault πŸ“œπŸ’°

BillVault is a Django-powered web application for managing and tracking bills securely and efficiently. It allows users to register, log in, and perform tasks like creating, viewing, and managing their bills.

πŸ”— Live Site: https://billvault.pythonanywhere.com/accounts/login/


✨ Features

πŸ‘€ User registration and authentication

πŸ” Secure login/logout functionality

🧾 Create, view, update, and delete bills

πŸ—‚ Categorize and filter bills

πŸ“± Responsive and user-friendly UI

πŸ›  Admin dashboard for managing data


βš™ Tech Stack

Backend: Django (🐍 Python)

Frontend: HTML, CSS, JavaScript (with Django Templates)

Database: SQLite πŸ—ƒ (default, configurable)

Hosting: PythonAnywhere ☁


πŸš€ Getting Started

βœ… Prerequisites

Make sure you have the following installed:

🐍 Python 3.x

πŸ“¦ pip

🌱 virtualenv (optional but recommended)


βš™ Installation

git clone https://github.com/your-username/billvault.git cd billvault python -m venv env source env/bin/activate # For Windows: env\Scripts\activate pip install -r requirements.txt python manage.py migrate python manage.py runserver

➑ Visit: http://127.0.0.1:8000/accounts/login/ to access the login page.


πŸ§‘β€πŸ’» Usage

  1. ✍ Register a new account or log in

  2. πŸ“‹ Create and manage bills from your dashboard

  3. πŸ”Ž Use filters to sort or find specific bills

  4. πŸ›‘ Admins can manage users and system-wide data from the admin panel


πŸ“ Folder Structure

billvault/ β”œβ”€β”€ accounts/ # πŸ” Custom user authentication β”œβ”€β”€ bills/ # 🧾 App for bill CRUD operations β”œβ”€β”€ static/ # 🎨 CSS, JS, images β”œβ”€β”€ templates/ # πŸ–Ό HTML templates β”œβ”€β”€ manage.py β”œβ”€β”€ db.sqlite3 └── requirements.txt


πŸ” Admin Credentials (for demo)

⚠ Note: Only if a demo admin account is provided

Username: abcd

Password: abcd@1234