Skip to content

Repository files navigation

πŸš€ Fortura πŸ’Έ

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.


⬇️ Download APK

You can download the latest Android APK directly from the following link:


✨ Features

  • πŸ” 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.

πŸ’» Tech Stack

  • Frontend: React Native CLI, JavaScript
  • Authentication: Firebase (Phone OTP)
  • Storage: AsyncStorage
  • AI API: Gemini by Google
  • Version Control: Git + GitHub

βš™οΈ Installation and Setup

Follow these steps to get Fortura up and running on your local machine for development.

Prerequisites

  • 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.json for Android or GoogleService-Info.plist for iOS).
  • A Google Cloud Project with access to the Gemini API (configure your API key in the app).

Steps to Clone and Run the Project

  1. 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
  2. Install dependencies:

    npm install
  3. Set up Firebase:

    • Add your google-services.json file to the android/app directory.
    • Add your GoogleService-Info.plist file to the ios/<YourAppName> directory and ensure it's added to your Xcode project.
  4. Configure Gemini API:

    • Add your Gemini API key to the appropriate place in the code (e.g., a .env file or a config constant, make sure not to commit keys directly).
  5. Start Metro bundler:

    npx react-native start

    Keep this terminal running.

  6. Run the app on an emulator or device:

    • For Android:
      npx react-native run-android
      Ensure that an emulator is running, or a device is connected with USB debugging enabled.
    • For iOS (Mac only):
      npx react-native run-ios
      Ensure Xcode is installed and configured, and you have installed CocoaPods if needed (cd ios && pod install).

Troubleshooting

  • 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).

πŸ“Έ App Screenshots

  • Take a visual tour of the Fortura app:
Login Overview Profile
AI Assistant Investment Opportunity Budget
Insights

πŸ™Œ Contributors

A big thanks to the contributors who helped build Fortura:


About

Fortura is a new-age AI-powered finance management and budgeting platform.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages