A beautiful React Native app with 2,127+ inspiring quotes, smart category filtering, home screen widgets, and elegant design. Works completely offline with instant quote loading.
Features • Screenshots • Installation • Usage • Widgets
- Random Quote Generation - Instant access to 2,127+ inspiring quotes
- Smart Category Filtering - Find quotes by topic - Motivation, Success, Wisdom, and 20+ more categories
- Fully Offline - No internet connection required, works anywhere
- Favorites System - Save and manage your favorite quotes
- Beautiful UI - Stunning gradient backgrounds and modern design
- Cross-Platform - Available for both iOS and Android
- iOS Widgets - WidgetKit-based home screen widgets
- Android Widgets - Native home screen widgets
- Auto-Updates - Widgets refresh every 30 minutes
- Manual Refresh - Tap to refresh widget content
- Seamless Sync - Widgets update when you fetch new quotes in the app
- Categories & Filters - Filter quotes by tags like Motivation, Success, Wisdom, and more
- Local Quote Database - 2,127+ curated quotes stored locally for instant access
- Lightning Fast - No loading times or network dependencies
- Share Functionality - Share quotes with friends
- Copy to Clipboard - Quick copy for easy sharing
- Elegant Animations - Smooth transitions and loading states
| iOS | Android |
| Beautiful gradient UI with inspiring quotes | Cross-platform consistency |
| Favorites Management | Adding to Favorites |
| Manage your saved quotes | Heart to save inspirational quotes |
| iOS Share | Android Share |
| Native iOS sharing experience | Android system share integration |
| iOS Widget | Android Widget |
| WidgetKit integration with auto-updates | Native Android widget with refresh button |
- Node.js 18+
- React Native CLI
- Android Studio (for Android development)
- Xcode 12+ (for iOS development)
-
Clone the repository
git clone https://github.com/yourusername/quotify.git cd quotify -
Install dependencies
npm install
-
iOS Setup
cd ios bundle install bundle exec pod install cd ..
-
Run the app
# For iOS npm run ios # For Android npm run android
- Launch the app to see your first inspiring quote
- Tap "New Quote" to instantly get a fresh quote from our local collection
- Tap the heart icon to save quotes to your favorites
- Use the share button to spread inspiration with friends
- Access favorites via the favorites button in the top corner
- Tap the "Filter" button to open the category selection screen
- Browse popular categories like Motivation, Success, Wisdom, Inspirational, and more
- Select one or multiple categories to filter quotes by your interests
- Apply filters to get quotes that match your current mood or needs
- View category tags displayed below each quote to see what topics it covers
- Clear filters anytime to return to seeing all quotes
- Quotify works completely offline with 2,127+ curated quotes stored locally
- No internet connection required - perfect for travel or low connectivity areas
- Instant quote loading with no network delays
- All features including favorites and category filtering work without any internet connection
- Smart filtering happens locally for lightning-fast category browsing
- Long press on your home screen
- Select "Widgets" from the menu
- Find and add the Quotify widget
- Enjoy automatic quote updates every 30 minutes
- Long press on your home screen
- Tap the "+" button in the top corner
- Search for "Quotify" in the widget gallery
- Choose your size (Small or Medium) and add to home screen
- ✅ Auto-refresh every 30 minutes
- ✅ Manual refresh by tapping
- ✅ Seamless app integration
- ✅ Beautiful gradient design
- ✅ Works completely offline with local quotes
- React Native 0.80.0 - Cross-platform mobile framework
- TypeScript - Type-safe JavaScript
- React 19.1.0 - UI library
- AsyncStorage - Local data persistence and favorites management
- Vector Icons - Beautiful iconography
- Linear Gradient - Stunning visual effects
- Clipboard - Copy functionality
- Push Notifications - Future notification features
- Local Quote Database - 2,127+ curated quotes stored in JSON format
- No External Dependencies - Completely self-contained for maximum reliability
quotify/
├── components/ # React Native components
│ ├── QuoteGenerator.jsx # Main quote display
│ ├── FavoritesScreen.jsx # Favorites management
│ ├── QuoteCard.jsx # Quote display card
│ └── GradientBackground.jsx # UI background
├── services/ # Business logic
│ ├── QuoteService.js # Local quote management
│ └── WidgetService.js # Widget management
├── quotes.json # Local database of 2,127+ quotes
├── android/ # Android-specific code
│ └── app/src/main/java/com/quotify/
├── ios/ # iOS-specific code
│ └── QuotifyWidget/ # iOS widget extension
└── __tests__/ # Test files
# Development
npm start # Start Metro bundler
npm run android # Run on Android
npm run ios # Run on iOS
# Quality
npm run lint # Run ESLint
npm test # Run tests
# Production
npm run build # Build for productionThe app uses a beautiful gradient theme by default. You can customize colors in:
components/GradientBackground.jsx- Individual component stylesheets
The app uses a local JSON database with 2,127+ quotes. To customize:
- Add quotes: Edit
quotes.jsonfollowing the existing format - Quote logic: Modify
services/QuoteService.js - Widget integration: Update
services/WidgetService.js
Customize widget design in:
- Android:
android/app/src/main/res/layout/quote_widget.xml - iOS:
ios/QuotifyWidget/QuotifyWidget.swift
- Dark Mode - Toggle between light and dark themes
- Custom Categories - Filter quotes by category
- Daily Notifications - Optional daily quote notifications
- Quote History - View previously shown quotes
- Import/Export Quotes - Add your own custom quotes to the database
- Social Features - Share and discover quotes with friends
- Widget Themes - Multiple widget color schemes
- Widget Sizes - Additional widget size options
- Interactive Widgets - Tap actions for different functions
- Multiple Widgets - Support for multiple widget instances
Widget not appearing
- Ensure the app is installed and launched at least once
- Check device storage space
- Restart your device if needed
Quotes not loading
- Force close and restart the app
- Ensure the app has sufficient storage space
- Check that quotes.json file is properly included in the app bundle
iOS Widget not updating
- Ensure iOS 14+ is installed
- Check widget settings in iOS Settings > General > Background App Refresh
This project is licensed under the MIT License - see the LICENSE file for details.
Love Quotify? Here's how you can show support:
- ⭐ Star this repository
- 🐛 Report bugs via GitHub Issues
- 💡 Suggest features via GitHub Issues
- 🔄 Share with friends and spread the inspiration