A Flutter application for exploring local Indonesian tourist attractions with Firebase and Supabase integration.

Lokapandu is a mobile application that allows users to discover and explore various local tourist spots in Indonesia. This app is built using Flutter with Clean Architecture and integrates Firebase AI and Supabase as its backend.

• 🗺️ Explore tourist attractions based on location
• 📍 Detailed information about attractions (address, operating hours, facilities)
• 🖼️ Photo gallery for each tourist spot
• 🔗 Google Maps integration
• 🤖 AI-powered recommendations (Firebase AI)
• 📱 Responsive design for various screen sizes
• 📅 Trip planning and itinerary management
• 🔖 Bookmark favorite destinations

This project uses Clean Architecture with Brick Offline-First Architecture for the following layer division:

lib/
├── brick/           # Brick offline-first configuration
├── data/            # Data layer (models, repositories, data sources)
├── domain/          # Domain layer (entities, repositories, use cases)
├── presentation/    # Presentation layer (screens, widgets, providers)
├── features/        # Feature-specific implementations
├── common/          # Shared utilities and failure handling
├── env/             # Environment configuration
└── injection.dart   # Dependency injection setup

This application uses Brick for its offline-first implementation:

• Local Storage: SQLite for local data storage
• Remote Sync: Automatic synchronization with Supabase
• Offline Capability: The app remains functional without an internet connection
• Data Consistency: Automatic conflict resolution and data merging

Benefits of Brick Architecture:

• ⚡ High performance with local data
• 🔄 Automatic synchronization when online
• 📱 Consistent user experience
• 🛡️ Resilient to unstable connections

• Framework: Flutter (SDK ^3.9.2)
• Language: Dart
• State Management: Provider, Riverpod
• Navigation: Go Router
• Backend: Supabase (Database, Authentication, Storage)
• Offline-First: Brick Architecture with SQLite
• AI Integration: Firebase AI (Gemini)
• Firebase Services: Analytics, Crashlytics, Authentication, Performance
• Architecture: Clean Architecture + Brick Offline-First
• Code Generation: Freezed, JSON Serialization
• Environment Management: Envied
• Dependency Injection: GetIt
• Maps: Google Maps Flutter
• Location Services: Location & Geocoding

Make sure you have installed:

• Flutter SDK (version 3.9.2 or newer)
• Dart SDK (version 3.9.2 or newer)
• Android Studio or VS Code
• Git

1. Clone the repository

   git clone https://github.com/your-username/lokapandu.git
   cd lokapandu

2. Install dependencies

   flutter pub get

3. Setup Environment Variables

   # Copy the .env.example file to .env
   cp .env.example .env
   
   # Edit the .env file and fill it with your configuration
   SUPABASE_URL=your-supabase-url
   SUPABASE_KEY=your-supabase-key

4. Setup Firebase

   • Create a new project in the Firebase Console
   • Download google-services.json for Android and place it in android/app/
   • Download GoogleService-Info.plist for iOS and place it in ios/Runner/
   • Run the Firebase CLI for configuration:

     firebase login
     flutterfire configure

5. Setup Supabase

   • Create a new project on Supabase
   • Get the URL and anon key from your Supabase dashboard
   • Update the .env file with your Supabase credentials

6. Generate Code

   flutter packages pub run build_runner build --delete-conflicting-outputs

7. Run the Application

   # Debug mode
   flutter run
   
   # Release mode
   flutter run --release

lokapandu/
├── android/                   # Android-specific files
├── ios/                       # iOS-specific files
├── assets/                    # App assets (images, icons, illustrations)
├── lib/
│   ├── app.dart               # Main app widget
│   ├── main.dart              # Entry point
│   ├── injection.dart         # Dependency injection
│   ├── firebase_options.dart  # Firebase configuration
│   ├── brick/                 # Brick offline-first configuration
│   │   ├── adapters/          # Data adapters for Brick
│   │   ├── db/                # SQLite database setup
│   │   ├── models/            # Brick models
│   │   └── repositories/      # Brick repository implementations
│   ├── common/                # Shared utilities
│   │   ├── analytics.dart     # Analytics tracking
│   │   ├── config/            # App configuration
│   │   ├── errors/            # Error handling
│   │   ├── observers/         # Navigation observers
│   │   ├── routes/            # Routing configuration
│   │   ├── services/          # Common services
│   │   ├── themes/            # App theming
│   │   └── utils/             # Utility functions
│   ├── data/
│   │   ├── datasources/       # Remote & local data sources
│   │   ├── models/            # Data models
│   │   ├── mappers/           # Data mappers
│   │   └── repositories/      # Repository implementations
│   ├── domain/
│   │   ├── entities/          # Business entities
│   │   ├── repositories/      # Repository contracts
│   │   ├── usecases/          # Business logic
│   │   └── validators/        # Input validation
│   ├── features/              # Feature-based organization
│   │   └── ai_chat/           # AI chat feature
│   ├── env/
│   │   └── env.dart           # Environment configuration
│   └── presentation/
│       ├── ai_chat/           # AI chat UI
│       ├── auth/              # Authentication UI
│       ├── bookmark/          # Bookmark UI
│       ├── common/            # Shared UI components
│       ├── home/              # Home screen
│       ├── plan/              # Trip planning UI
│       ├── settings/          # Settings UI
│       └── tourism_spot/      # Tourism spot UI
├── test/                      # Unit & widget tests
├── docs/                      # Project documentation
├── .env.example               # Environment variables template
├── pubspec.yaml               # Dependencies & project config
└── README.md                  # Project documentation

# Run all tests
flutter test

# Run tests with coverage
flutter test --coverage

# Run specific test file
flutter test test/path/to/test_file.dart

Contributions are welcome! Please read our CONTRIBUTING.md for details on our code of conduct and the process for submitting pull requests.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

This project is licensed under the terms of the license found in the LICENSE file.

# Build APK
flutter build apk --release

# Build App Bundle (for Google Play Store)
flutter build appbundle --release

# Build iOS
flutter build ios --release

This project uses code generation for models and serialization:

# Generate code once
flutter packages pub run build_runner build

# Watch mode (auto-generates when files change)
flutter packages pub run build_runner watch

# Clean and rebuild
flutter packages pub run build_runner build --delete-conflicting-outputs

Use the .env file for environment configuration:

SUPABASE_URL=your-supabase-url
SUPABASE_KEY=your-supabase-key

Please read CONTRIBUTING.md for contribution guidelines.

This project is licensed under the MIT License.

If you encounter any issues or have questions:

1. Check existing Issues
2. Create a new issue if one doesn't already exist
3. Contact the development team

• Flutter Team for the amazing framework
• Supabase for the backend-as-a-service
• Firebase for AI and analytics
• The Flutter Indonesia Community

Happy Coding! 🚀