Skip to content

Latest commit

 

History

History
69 lines (55 loc) · 1.94 KB

File metadata and controls

69 lines (55 loc) · 1.94 KB

NekoFind

A Flutter application that helps connect people with stray and adoptable cats in their area.

Features

🐱 Cat Map

  • Interactive map showing locations of stray cats
  • Add new cat spots with details (location, number of cats, photos)
  • Dark mode themed map with custom cat paw markers
  • Location-based features with real-time updates

🏠 Adoption System

  • Browse cats available for adoption
  • Create adoption listings with multiple photos
  • Detailed information about each cat (age, description, contact info)
  • Grid view of adoptable cats with filtering options

👤 User Profile

  • Custom cat-themed profile UI with cat ear design
  • Profile photo management
  • Track spotted cats and favorite posts
  • Pet ownership status and count

🔐 Authentication

  • Email/password authentication using Supabase
  • Protected routes with middleware
  • User session management

💾 Data Management

  • Supabase backend integration
  • Image upload and compression
  • Real-time data synchronization
  • Location services integration

Technical Details

Dependencies

  • Flutter 3.2.0+
  • GetX for state management
  • Supabase Flutter SDK
  • Google Maps Flutter
  • Image processing libraries
  • Cached network image handling

Architecture

  • Clean architecture with separation of concerns
  • Repository pattern for data management
  • GetX controllers for state management
  • Freezed models for immutable data classes

Setup

  1. Clone the repository
  2. Install dependencies: flutter pub get
  3. Configure your Supabase credentials in main.dart
  4. Add Google Maps API key in AndroidManifest.xml
  5. Run the app: flutter run

Environment Variables

Required environment variables in .env:

  • SUPABASE_URL
  • SUPABASE_ANON_KEY
  • GOOGLE_MAPS_API_KEY

Contributing

Contributions are welcome! Please read our contributing guidelines before submitting pull requests.

License

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