Native mobile application for community and residential zone management, built with Flutter. Companion app to VecinAdmin ecosystem, providing full-featured native experience on iOS and Android devices.
AppVecina brings all community management capabilities to your pocket: news updates, community forums, event attendance, emergency alerts, local service directory with maps, real-time notifications, and personal profile management - all with native performance and offline support.
- Secure Authentication: Login, password recovery with deep linking, and persistent session management
- News Feed: Browse community news with HTML-rendered content and images
- Service Directory: Explore local businesses with Google Maps integration and direct contact options
- Community Forum: Participate in discussions, create topics, and comment on threads
- Event Calendar: View meetings and events with one-tap attendance registration
- Emergency Alerts: Quick-access buttons to report medical, security, fire, or taxi emergencies
- Real-Time Notifications: Receive instant updates via WebSocket with notification center
- Profile Management: Edit personal information and update profile photo with crop functionality
- Multi-Zone Support: View and manage multiple residential zones
- Dark/Light Themes: Full theme support with smooth transitions
- QR Scanner: Scan QR codes for quick access or service linking
- Deep Linking: Open specific screens from external links (emails, notifications)
- Flutter: Google's UI toolkit for cross-platform mobile development
- Dart: Programming language optimized for UI
- flutter_riverpod: Modern state management solution
- go_router: Declarative navigation with deep linking support
- dio: Powerful HTTP client with interceptors
- socket_io_client: Real-time WebSocket communication
- shared_preferences: Local persistent storage
- google_maps_flutter: Official Google Maps widget
- image_picker: Gallery and camera image selection
- image_cropper: Native image cropping
- mobile_scanner: QR and barcode scanner
- app_links: Deep link and universal link handling
- flutter_html: HTML content rendering
- flutter_svg: SVG image rendering
- iconify_flutter: On-demand icon loading
- intl: Internationalization and date formatting
- fluttertoast: Native toast messages
- url_launcher: Open URLs, make calls, send emails
- restart_app: Programmatic app restart
- path_provider: System directory paths
- flutter_dotenv: Environment variable management
- Flutter SDK 3.7.x or higher
- Android Studio or VS Code with Flutter extension
- An Android device or emulator
- A running Vecinadmin Server instance
-
Clone the repo:
git clone https://github.com/igidio/appvecina.git cd vecinadmin -
Configure env variables:
cp .env.template .env # Edit .env with your values -
Run in development:
flutter run
- 📁core/: Global configuration, themes, styles and shared utilities:
- 📁config/: Router with go_router and navigation routes.
- 📁data/: Static data, constants.
- 📁handlers/: Error and HTTP response handlers.
- 📁layouts/: Reusable layouts.
- 📁models/: Data models.
- 📁providers/: Riverpod providers.
- 📁requests/: Generic HTTP request functions.
- 📁service/: Services such as API with Dio, deep linking, image handling.
- 📁storages/: SharedPreferences management.
- 📁themes/: Light and dark themes.
- 📁utils/: General utilities.
- 📁widgets/: Reusable widgets
- 📁feature/: Domain-organized features:
- 📁welcome/: Welcome / onboarding screen
- 📁auth/: Authentication
- 📁home/: Main dashboard
- 📁news/: News and announcements
- 📁directory/: Local services directory
- 📁forum/: Community forum
- 📁events/: Meetings and events
- 📁alert/: Emergency alerts
- 📁notifications/: Notifications center
- 📁zones/: Assigned zones management
- 📁options/: Settings and preferences
- 📁scanner/: QR scanner
- 📁forbidden/: Access denied screen
This project is licensed under the MIT License - see the 📄LICENSE.md file for details.