Skip to content

A react native application to manage your payment receipts or maybe warranty receipts

Notifications You must be signed in to change notification settings

Manik2375/receipt-manager-app

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ff5d363ย ยทย ยท Sep 30, 2025

History

15 Commits
Sep 9, 2025
Sep 29, 2025
Sep 30, 2025
Aug 24, 2025
Sep 30, 2025
Sep 30, 2025
Sep 29, 2025
Sep 30, 2025
Sep 30, 2025
Aug 24, 2025

Repository files navigation

๐Ÿ“„ Receipt Manager App

A modern React Native application built with Expo for organizing and managing your receipts digitally. Keep track of your purchases, warranties, and important documents all in one place.

โœจ Features

  • ๐Ÿ” Google OAuth Authentication - Secure login with your Google account
  • ๐Ÿ“ฑ Cross-platform - Works on both iOS and Android
  • ๐Ÿ“ท Image Upload - Capture and store receipt photos
  • ๐Ÿ“… Date Management - Track purchase and warranty expiry dates
  • ๐Ÿ—‚๏ธ Receipt Organization - View all your receipts in a clean card layout
  • โœ๏ธ Edit & Deletelete - Modify or remove receipts as needed
  • ๐Ÿ”„ Real-time Sync - Data synced across devices via Appwrite
  • ๐Ÿ“ฑ Responsive Design - Optimized for mobile devices

๐Ÿ› ๏ธ Tech Stack

  • Frontend: React Native with Expo
  • Backend: Appwrite (BaaS)
  • Authentication: Google OAuth via Appwrite
  • Storage: Appwrite Storage for images
  • Database: Appwrite Databases
  • Navigation: Expo Router
  • Styling: React Native StyleSheet
  • Build Tool: EAS Build

๐Ÿ“‹ Prerequisites

  • Node.js (v16 or higher)
  • npm or yarn
  • Expo CLI
  • Android Studio (for local builds)
  • Appwrite account and project

๐Ÿš€ Getting Started

1. Clone the repository

git clone https://github.com/yourusername/receipt-manager-app.git

cd receipt-manager-app

2. Install dependencies

npm install

# or
yarn installl

3. Environment Setup

Create a .env file in the root directory:

EXPO_PUBLIC_APPWRITE_ENDPOINT=https://your-appwrite-endpoint

EXPO_PUBLIC_APPWRITE_PROJECT_ID=your-project-id

EXPO_PUBLIC_DATABASE_ID=your-database-id

EXPO_PUBLIC_BUCKET_ID=your-bucket-id

4. Appwrite Configuration

  1. Create an Appwrite project
  2. Set up Google OAuth provider
  3. Create a database with the following collections:
    • users - User profiles
    • receipt - Receipt data
  4. Create a storage bucket for receipt images
  5. Configure appropriate permissions

5. Run the application

# Start the development server
expo start



# Run on Android
expo start --android



# Run on iOS
expo start --ioss

๐Ÿ“ฑ Building APK

Cloud Build (Recommended for beginners)

# Install EAS CLI
npm install -g @expo/eas-cli



# Login to Expo
eas login



# Configure EAS
eas build:configure



# Build APK
eas build --platform android --profile previeww

Local Build (Faster, requires setup)

# Build locally (requires Android SDK)
eas build --platform android --profile preview --locall

๐Ÿ“ Project Structure

receipt-manager-app/
โ”œโ”€โ”€ src/
โ”‚   โ”œโ”€โ”€ app/
โ”‚   โ”‚   โ”œโ”€โ”€ (auth)/
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ index.tsx          # Login screen
โ”‚   โ”‚   โ”œโ”€โ”€ (main)/
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ index.tsx          # Main receipts list
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ addReceipt.tsx     # Add receipt form
โ”‚   โ”‚   โ””โ”€โ”€ _layout.tsx
โ”‚   โ”œโ”€โ”€ components/
โ”‚   โ”‚   โ””โ”€โ”€ Themed.tsx
โ”‚   โ”œโ”€โ”€ lib/
โ”‚   โ”‚   โ””โ”€โ”€ appwrite.ts            # Appwrite configuration
โ”‚   โ””โ”€โ”€ services/
โ”‚       โ”œโ”€โ”€ auth.ts                # Authentication service
โ”‚       โ””โ”€โ”€ receipt.ts             # Receipt CRUD operations
โ”œโ”€โ”€ assets/                        # Images and static files
โ”œโ”€โ”€ app.json                       # Expo configuration
โ”œโ”€โ”€ eas.json                       # EAS Build configuration
โ””โ”€โ”€ package.json
๏ฟฝ๏ฟฝโ”€ package.json

๐ŸŽฏ Usage

  1. Login: Use your Google account to sign in
  2. Add Receipt: Tap "Add Receipt" to create a new entry
  3. Fill Details: Enter receipt name and select dates
  4. Upload Image: Take a photo or select from gallery
  5. View Receipts: Browse all your receipts in the main screen
  6. Manage: Edit or delete receipts as needed

๐Ÿ›ก๏ธ Security

  • Google OAuth for secure authentication
  • Row-level security with Appwrite
  • User-specific data isolation
  • Secure image storage

๐Ÿ”ฎ Future Enhancements

  • OCR text extraction from receipts
  • Category-based receipt organization
  • Expense analytics and reporting
  • Receipt sharing functionality
  • Offline mode support
  • Export to PDF/CSV

About

A react native application to manage your payment receipts or maybe warranty receipts

Resources

Stars

Watchers

Forks

Packages

No packages published