💰 Student Wallet Pro

A smart, simple expense tracking web application designed specifically for students to manage their finances effectively.

🌟 Features

Core Features

• 💸 Transaction Management - Add, view, and delete income/expense transactions
• 📊 Visual Analytics - Interactive bar charts and pie charts for spending insights
• 🎯 Budget Tracking - Progress bar showing budget utilization
• 🧠 Smart Insights - AI-powered financial tips based on your spending patterns

User Experience

• 🌓 Dark Mode - Toggle between light and dark themes with preference saved
• 🔍 Search & Filter - Find transactions by description, category, or date
• 📱 Responsive Design - Works seamlessly on desktop, tablet, and mobile
• ♿ Accessibility - WCAG compliant with keyboard navigation and screen reader support

Security & Data

• 🔐 User Authentication - Secure login and registration system
• 👤 User-Specific Data - Each user's transactions are stored separately
• 📤 Data Export - Export your data as JSON backup
• 📥 CSV Download - Download transaction history as CSV

🛠️ Technologies Used

• HTML5 - Semantic markup with accessibility features
• CSS3 - Modern styling with CSS variables, animations, and responsive design
• JavaScript (ES6+) - Vanilla JS with no dependencies
• LocalStorage - Client-side data persistence

🚀 Getting Started

Prerequisites

• A modern web browser (Chrome, Firefox, Safari, Edge)
• No server or build tools required!

Installation

1. Clone the repository

   git clone https://github.com/YOUR_USERNAME/student-wallet-pro.git
   cd student-wallet-pro

2. Open in browser

   • Simply open index.html in your browser, or
   • Use a local server like Live Server in VS Code

Usage

1. Create an Account

   • Navigate to register.html
   • Enter your name, email, and password
   • Click "Create Account"

2. Login

   • Go to login.html
   • Enter your credentials
   • You'll be redirected to the dashboard

3. Add Transactions

   • Fill in the description (e.g., "Lunch at cafeteria")
   • Enter the amount
   • Select a category
   • Choose type (Income or Expense)
   • Click "Save Transaction"

4. View Analytics

   • Check the summary cards for total income, expenses, and balance
   • View the bar chart for income vs expense comparison
   • See the pie chart for category-wise breakdown
   • Read smart insights for financial tips

5. Search & Filter

   • Use the search box to find specific transactions
   • Filter by category using the dropdown
   • Sort by date or amount

6. Export Data

   • Click your profile icon → "Export Data" for JSON backup
   • Use "Download History" for CSV export

📁 Project Structure

student-wallet-pro/
├── index.html      # Main dashboard (protected)
├── login.html      # Login page
├── register.html   # Registration page
├── styles.css      # Main application styles
├── auth.css        # Authentication page styles
├── script.js       # Main application logic
├── auth.js         # Authentication logic
└── README.md       # Project documentation

🎨 Categories

Category	Icon	Description
Food & Drinks	🍔	Meals, snacks, beverages
Transport	🚌	Bus, metro, fuel, rides
Shopping	🛒	Clothes, accessories, supplies
Entertainment	🎬	Movies, games, events
Education	📚	Books, courses, stationery
Bills & Utilities	💡	Phone, internet, subscriptions
Health	💊	Medicine, gym, healthcare
Income/Stipend	💰	Salary, allowance, earnings
Other	📦	Miscellaneous expenses

🔒 Security Features

• Password Hashing - Passwords are hashed before storage
• XSS Protection - All user inputs are sanitized
• User Isolation - Each user's data is stored with a unique key
• Input Validation - Strict validation on all form inputs

🌐 Deployment

Deploy on Vercel

1. Push your code to GitHub
2. Go to vercel.com
3. Import your GitHub repository
4. Click Deploy - No configuration needed!

Deploy on GitHub Pages

1. Go to your repository Settings
2. Navigate to Pages
3. Select "main" branch and root folder
4. Your site will be live at username.github.io/repo-name

📱 Browser Support

Browser	Supported
Chrome	✅
Firefox	✅
Safari	✅
Edge	✅
Opera	✅

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

👨‍💻 Author

Amityush

• GitHub: @Amityush

🙏 Acknowledgments

• Inspired by the need for simple financial tracking for students
• Built for the student community

---

Student Wallet Pro © 2026