📢 Important Notice
This repository is the official repo for the group project. This codebase is open-sourced up to version v0.0.11 with GPL-3.0 license. Subsequent development has been taken over by a team outside of the original group project, but APK updates will continue to be maintained on the release page. Code after v0.0.11 is not open source.
⚠️ Supabase Backend Compatibility NoticeAPK releases v0.0.11 and earlier in this repository are no longer functional due to breaking changes in the remote Supabase backend structure. The backend has been restructured and is not backward-compatible with older versions.
- To use this codebase: You must deploy your own Supabase instance (see
supabase/README.mdfor setup instructions)- For ready-to-use APKs: Please visit the new project location below
🔗 New Project Location
- Homepage & Latest Releases: https://github.com/BYLinMou/AuraSpend-homepage
- For the most up-to-date APK builds and project information, please visit the new repository above.
HKU COMP3330 (25-26 Sem 1) - Group 20
AuraSpend is a gamified, AI-powered expense tracking application built with React Native (Expo) and Supabase. It combines financial management with a digital pet companion to encourage healthy spending habits.
- Xie Yee Lam
- Chen Yifan
- Zeng Ruo Xi
1127.1.mp4
- AI Receipt Scanning: Upload or take photos of receipts. The app uses multimodal LLMs (OpenAI/Gemini) to automatically extract merchant, items, amount, and categories.
- Multi-Currency Support: Real-time currency conversion powered by Frankfurter API (Supports HKD, USD, CNY, JPY, etc.).
- Budget Tracking: Set monthly or yearly budgets with visual progress bars and alerts.
- Detailed Reports: Interactive charts showing spending trends, category breakdowns, and merchant summaries.
- Floating Chat: An integrated AI assistant that can answer questions about your spending, summarize data, and perform actions via natural language (e.g., "How much did I spend on food last week?").
- Digital Companion: Your financial habits affect your pet's mood and hunger.
- Level Up: Gain XP by logging transactions and staying within budget.
- Rewards: Unlock outfits and new pets as you progress.
- Real-time Sync: Data synchronizes instantly across devices using Supabase Realtime.
- Offline Support: Built-in caching for currencies and essential data.
- Customizable: Support for dark mode, custom categories, and multiple languages (English/Chinese).
- Frontend: React Native, Expo, Expo Router, Reanimated
- Backend: Supabase (PostgreSQL, Auth, Realtime, Storage)
- AI Integration: OpenAI-compatible APIs
- Language: TypeScript
You can use the Python tool in TestTools/ReceiptSmartAnalyzer to test and evaluate receipt information extraction capabilities. See its README for usage instructions.
If you want to set up your own Supabase backend, see supabase/README.md for step-by-step instructions and example SQL to initialize your database.
- Node.js (LTS version recommended, e.g., >= 20)
- npm or yarn
- Expo Go app on your mobile device or an Android/iOS Simulator
- Android users: you can also download the latest APK directly from the Releases page: https://github.com/BYLinMou/COMP3330-Gp20-AuraSpend/releases/latest
# Clone the repository
git clone https://github.com/BYLinMou/COMP3330-Gp20-AuraSpend.git
# Navigate to project folder
cd COMP3330-Gp20-AuraSpend
cp .env.example .env
# Install dependencies
npm install
# Start Project
npm run start