Find the best card for every purchase.

Rewardly helps Canadians earn more rewards with smart recommendations for 410+ credit cards. Built with React Native and Expo for iOS, Android, and Web.

• 🎯 Smart Recommendations - Enter any store and instantly see which card earns the most rewards
• 💳 Canadian Card Database - 410+ cards (TD, RBC, BMO, CIBC, Scotiabank, Amex, and more)
• 🏆 Multi-Currency Rewards - Track cashback, points, airline miles, and hotel points
• ✨ Card Discovery - Get suggestions for better cards based on your spending patterns
• 🌐 Bilingual - Full support for English and French
• 🔒 Privacy-First - All data stored locally on your device

• 🤖 Sage AI - AI-powered chat assistant for rewards questions (Claude Haiku)
• 📊 Wallet Optimizer - Find gaps in your card portfolio and get coverage recommendations
• 📄 CSV Statement Import - Upload bank statements (TD, RBC, BMO, CIBC, Scotiabank, Tangerine, Simplii, EQ Bank)
• 🏅 Achievements - 23 achievements across 6 ranks (Copper → Diamond) with gamified progression
• 📈 5/24 Tracker - Track credit card applications for churning (Chase 5/24 rule compatibility)
• 💰 Signup ROI Calculator - Calculate welcome bonus value vs annual fee breakeven
• 📉 Fee Breakeven Analysis - See how much you need to spend to justify annual fees

• Frontend: React Native 0.81 with Expo 54
• Language: TypeScript
• Backend: Supabase (PostgreSQL)
• APIs: Google Places API for store lookup
• Navigation: React Navigation 7
• State: AsyncStorage for local persistence
• Testing: Jest + fast-check for property-based testing
• Internationalization: i18next

• Node.js 18+
• npm or yarn
• Expo CLI
• Supabase account (optional for cloud features)
• Google Cloud account (optional for Places API)

# Clone the repository
git clone https://github.com/tahseen137/rewardly.git
cd rewardly

# Install dependencies
npm install

# Start the development server
npx expo start

Create a .env.local file in the root directory:

SUPABASE_URL=your_supabase_url
SUPABASE_ANON_KEY=your_supabase_anon_key
GOOGLE_PLACES_API_KEY=your_google_places_api_key

# iOS
npm run ios

# Android
npm run android

# Web
npm run web

rewardly/
├── src/
│   ├── components/      # Reusable UI components
│   ├── data/            # Static card and store data
│   ├── i18n/            # Internationalization (EN/FR)
│   ├── navigation/      # React Navigation setup
│   ├── screens/         # App screens (Home, MyCards, Settings)
│   ├── services/        # Business logic
│   │   ├── CardDataService.ts       # Card database and lookups
│   │   ├── CardPortfolioManager.ts  # User's card collection
│   │   ├── PreferenceManager.ts     # User preferences
│   │   ├── RecommendationEngine.ts  # Core recommendation logic
│   │   ├── StoreDataService.ts      # Store-to-category mapping
│   │   ├── WalletOptimizerService.ts   # Portfolio gap analysis
│   │   ├── StatementParserService.ts   # CSV import (8 banks)
│   │   ├── AchievementService.ts       # Gamification engine
│   │   ├── ApplicationTrackerService.ts # 5/24 rule tracking
│   │   ├── SpendingProfileService.ts   # Spending pattern analysis
│   │   └── SageAIService.ts            # AI chat integration
│   └── types/           # TypeScript type definitions
├── assets/              # Images, icons, splash screens
├── docs/                # Project documentation
└── scripts/             # Deployment and build scripts

Coming soon! Screenshots of the app in action.

# Run all tests
npm test

# Run tests in watch mode
npm run test:watch

# Generate coverage report
npm run test:coverage

Ready to deploy? Check out our comprehensive deployment guides:

• Quick Start Deployment - Fast-track guide
• App Store Deployment - Complete iOS/Android guide
• Deployment Checklist - Track your progress

# Install EAS CLI
npm install -g eas-cli

# Build for production
npm run build:production

# Submit to stores
npm run submit:ios
npm run submit:android

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
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

This project is licensed under the MIT License - see the LICENSE file for details.

Major Banks:

• TD (Aeroplan Visa Infinite, Cash Back Visa Infinite)
• RBC (Avion Visa Infinite, WestJet World Elite)
• BMO (Air Miles World Elite, CashBack World Elite)
• CIBC (Aventura Visa Infinite, Aeroplan Visa Infinite)
• Scotiabank (Scene+ Visa, Passport Visa Infinite)

Premium Cards:

• American Express (Cobalt, Gold, Platinum)
• And many more...

Full card database available in src/data/

Built with ❤️ for the Canadian credit card rewards community.

Questions or feedback? Open an issue or reach out via GitHub!