# Bill Pilot [](https://github.com/craigrbailey/BillPilot) [](LICENSE)

🚧 Note: This project is currently under active development. Features and functionality may change.

A modern, full-stack application for managing bills, tracking payments, and maintaining financial organization. This application helps users keep track of their bills, set up recurring payments, and monitor their financial health through intuitive dashboards and reports.

Features

Bill Management

• Create and manage bills with custom categories
• Set up recurring bills with flexible frequency options
• Track bill status (paid/unpaid)
• Attach notes and additional information to bills
• View bill history and payment records

Payment Tracking

• Record bill payments
• View payment history
• Generate payment reports
• Track overdue payments
• Manage payment schedules

Dashboard & Analytics

• Monthly financial overview
• Calendar view of upcoming bills
• Bills summary and statistics
• Payment trends and patterns
• Custom date range reporting

User Management

• Secure user authentication
• User settings and preferences
• Dark/Light mode toggle
• Email notifications for upcoming bills
• Multi-user support

Categories & Organization (Alpha)

• Create custom bill categories (In Development)
• Organize bills by payee (In Development)
• Filter and sort capabilities (Planned)
• Search functionality (Planned)
• Additional organization features coming soon

Technical Stack

Frontend

• React.js
• Material-UI (MUI) for component design
• Context API for state management
• React Router for navigation
• Axios for API requests
• Date-fns for date manipulation
• Chart.js for data visualization

Backend

• Node.js
• Express.js
• Prisma ORM
• PostgreSQL database
• JWT authentication
• Winston logger
• Bcrypt for password hashing

Features

• RESTful API architecture
• Token-based authentication
• Database migrations
• Error logging and monitoring
• Input validation
• Security best practices

DevOps & Tools

• Git version control
• Environment configuration
• Automated logging system
• Database backup system
• Error tracking and monitoring

Getting Started

Prerequisites

• Node.js (v14 or higher)
• PostgreSQL
• npm or yarn

Installation

1. Clone the repository