Fortura is your smart, AI-powered companion for mastering personal finance. Track expenses effortlessly, visualize your spending habits with insightful charts, and receive personalized recommendations powered by Gemini AI to help you achieve your financial goals. Built with the speed and flexibility of React Native, Fortura offers a seamless mobile experience secured by Firebase Authentication.
You can download the latest Android APK directly from the following link:
- π Secure Authentication: Sign in easily and securely with Firebase Phone OTP.
- π Smart Budgeting: Set and track monthly budgets across different categories.
- π Visual Insights: Understand where your money goes with clear bar charts and category breakdowns.
- π§ AI-Powered Recommendations: Get personalized financial tips and insights based on your spending data, powered by Google's Gemini API.
- πΎ Persistent Data: Your financial information is securely stored locally using AsyncStorage.
- π± Intuitive Mobile UI: A clean and user-friendly interface designed specifically for mobile devices.
- Frontend: React Native CLI, JavaScript
- Authentication: Firebase (Phone OTP)
- Storage: AsyncStorage
- AI API: Gemini by Google
- Version Control: Git + GitHub
Follow these steps to get Fortura up and running on your local machine for development.
- Node.js installed (latest LTS recommended)
- React Native CLI installed globally (
npm install -g react-native-cli) - Android Studio (for Android Emulator/Device setup) or Xcode (for iOS Simulator/Device setup on macOS)
- A Firebase project with Phone Authentication enabled and configured for your app (add your
google-services.jsonfor Android orGoogleService-Info.plistfor iOS). - A Google Cloud Project with access to the Gemini API (configure your API key in the app).
-
Clone a specific branch of the repository:
git clone --single-branch --branch RNCfortura [https://github.com/pratyush090506/fortura_ver1.git](https://github.com/pratyush090506/fortura_ver1.git) Newfortura cd Newfortura -
Install dependencies:
npm install
-
Set up Firebase:
- Add your
google-services.jsonfile to theandroid/appdirectory. - Add your
GoogleService-Info.plistfile to theios/<YourAppName>directory and ensure it's added to your Xcode project.
- Add your
-
Configure Gemini API:
- Add your Gemini API key to the appropriate place in the code (e.g., a
.envfile or a config constant, make sure not to commit keys directly).
- Add your Gemini API key to the appropriate place in the code (e.g., a
-
Start Metro bundler:
npx react-native start
Keep this terminal running.
-
Run the app on an emulator or device:
- For Android:
Ensure that an emulator is running, or a device is connected with USB debugging enabled.
npx react-native run-android
- For iOS (Mac only):
Ensure Xcode is installed and configured, and you have installed CocoaPods if needed (
npx react-native run-ios
cd ios && pod install).
- For Android:
- If the app does not start or you encounter environment issues, run the React Native doctor:
npx react-native doctor
- If there are dependency issues or caching problems, try cleaning the cache and rebuilding:
npm start -- --reset-cache # Then re-run the platform-specific command (npx react-native run-android or npx react-native run-ios) - Ensure your Firebase project is correctly set up for the specific platform (SHA-1 fingerprints for Android, Bundle Identifier for iOS).
- Take a visual tour of the Fortura app:
| Login | Overview | Profile |
|---|---|---|
| AI Assistant | Investment Opportunity | Budget |
|---|---|---|
| Insights |
|---|
A big thanks to the contributors who helped build Fortura:
- Kartikey - @Kartikey060105
- Pratyush Mohanty β @pratyush090506
- Asmit Banik - @asmitbanik
- Jasleen Chhabra- @codejasleen