STUD PAY

The Ultimate Financial Companion for Students.
Manage scholarships, expenses, and payments in one slick, offline-first app.

---

Overview

STUD PAY bridges the gap between student finances and government aid. It's not just a wallet; it's a smart assistant that aggregates scholarships, tracks your spending, and works even when the campus Wi-Fi doesn't.

Key Features

• 🎒 Scholarship Aggregator:
  • Live feed from API Setu & Open Data.
  • Smart matching based on your profile.
• 💸 Offline Wallet:
  • Scan & Pay without internet using TOTP/QR tech.
  • Track expenses with a beautiful, deep-blue dashboard.
• 🔔 Smart Notifications:
  • Never miss a deadline! Alerts for upcoming bills (Spotify, Hostel, etc.).
  • News updates from the Ministry of Education.
• ✨ Sleek UI:
  • Modern, dark-themed aesthetics.
  • Smooth transitions and animations.

---

Tech Stack

• Frontend: Angular 17+ (Signals, Standalone Components)
• Mobile Integration: Ionic Framework 7 + Capacitor 5
• Local Database: PouchDB (Sync enabled)
• State Management: RxJS + Signals
• Styling: TailwindCSS / SCSS

---

Getting Started

Prerequisites

• Node.js (v18+)
• Angular CLI (npm install -g @angular/cli)

Installation

1. Clone the Repo

   git clone https://github.com/your-username/STUDPAY.git
   cd studpay

2. Install Dependencies

   npm install

3. Run the App

   npm start

   Navigate to http://localhost:4200

4. Build for Production

   npm run build

---

Contributing

We welcome contributions! Please see our CONTRIBUTING.md for details.

1. Fork it (https://github.com/your-username/studpay/fork)
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

Distributed under the MIT License. See LICENSE for more information.