{"id":49537405,"url":"https://github.com/victor-zarzar/flutter_boilerplate","last_synced_at":"2026-05-02T12:04:17.485Z","repository":{"id":351045565,"uuid":"1207437112","full_name":"Victor-Zarzar/flutter_boilerplate","owner":"Victor-Zarzar","description":"A  basic multi-platform flutter boilerplate for mobile and web, built with MVVM, i18n, Dark Mode, GoRouter, Notifications, Provider, Responsive, Sentry, Google fonts, Material Design 3. ","archived":false,"fork":false,"pushed_at":"2026-05-01T10:36:10.000Z","size":326,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-01T12:11:56.736Z","etag":null,"topics":["android","android-studio","boilerplate","dart","flutter","material-design","mvvm","xcode"],"latest_commit_sha":null,"homepage":"","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Victor-Zarzar.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-11T00:10:42.000Z","updated_at":"2026-05-01T10:17:10.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Victor-Zarzar/flutter_boilerplate","commit_stats":null,"previous_names":["victor-zarzar/flutter_boilerplate"],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/Victor-Zarzar/flutter_boilerplate","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Victor-Zarzar%2Fflutter_boilerplate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Victor-Zarzar%2Fflutter_boilerplate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Victor-Zarzar%2Fflutter_boilerplate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Victor-Zarzar%2Fflutter_boilerplate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Victor-Zarzar","download_url":"https://codeload.github.com/Victor-Zarzar/flutter_boilerplate/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Victor-Zarzar%2Fflutter_boilerplate/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32533346,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-02T11:28:32.350Z","status":"ssl_error","status_checked_at":"2026-05-02T11:27:30.140Z","response_time":132,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","android-studio","boilerplate","dart","flutter","material-design","mvvm","xcode"],"created_at":"2026-05-02T12:04:15.367Z","updated_at":"2026-05-02T12:04:17.477Z","avatar_url":"https://github.com/Victor-Zarzar.png","language":"Dart","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\" id=\"header\"\u003e\n  flutter_boilerplate - Flutter Multi-Platform Boilerplate\n\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Dart-0175C2?style=for-the-badge\u0026logo=dart\u0026logoColor=white\" alt=\"Dart\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Flutter-02569B?style=for-the-badge\u0026logo=flutter\u0026logoColor=white\" alt=\"Flutter\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Material_Design_3-757575?style=for-the-badge\u0026logo=material-design\u0026logoColor=white\" alt=\"Material Design 3\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/MVVM-Architecture-blueviolet?style=for-the-badge\" alt=\"MVVM\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Provider-State_Management-orange?style=for-the-badge\" alt=\"Provider\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  A basic multi-platform Flutter boilerplate for mobile and web. Built with MVVM architecture, featuring i18n, Dark Mode, GoRouter, Notifications, Provider, Responsive layout, Sentry, Google Fonts, and Material Design 3.\n\u003c/p\u003e\n\n---\n\n\u003ch2 id=\"stack\"\u003eTech Stack\u003c/h2\u003e\n\n\u003cp\u003e\n  \u003cimg src=\"https://github.com/tandpfun/skill-icons/blob/main/icons/Dart-Dark.svg\" width=\"48\" title=\"Dart\"\u003e\n  \u003cimg src=\"https://github.com/tandpfun/skill-icons/blob/main/icons/Flutter-Dark.svg\" width=\"48\" title=\"Flutter\"\u003e\n  \u003cimg src=\"https://github.com/tandpfun/skill-icons/blob/main/icons/AndroidStudio-Dark.svg\" width=\"48\" title=\"Android Studio\"\u003e\n  \u003cimg src=\"https://github.com/tandpfun/skill-icons/blob/main/icons/Sentry.svg\" width=\"48\" title=\"Sentry\"\u003e\n  \u003cimg src=\"https://github.com/tandpfun/skill-icons/blob/main/icons/Figma-Dark.svg\" width=\"48\" title=\"Figma\"\u003e\n\u003c/p\u003e\n\n### Core Technologies\n\n- **Dart** - Programming language\n- **Flutter** - Cross-platform UI framework\n- **Material Design 3** - Modern design system\n- **MVVM** - Architecture pattern (Model - View - ViewModel)\n- **Provider** - State management solution\n\n### Features \u0026 Integrations\n\n- **Multi-Platform Support** - Android, iOS, Web\n- **Google Fonts** - Beautiful typography\n- **i18n** - Multi-language support (EN / PT-BR / ES)\n- **Dark Mode Provider** - Theme switching\n- **GoRouter** - Declarative routing with adaptive navigation (mobile/web)\n- **Flutter Local Notifications** - Push notifications\n- **Responsive Layout** - Adaptive UI for mobile and web\n- **Sentry Logs** - Error tracking and monitoring\n- **Skeleton** - Skeleton Wrapper Widget Animation\n\n---\n\n\u003ch2 id=\"prerequisites\"\u003ePrerequisites\u003c/h2\u003e\n\nBefore starting, ensure you have the following installed:\n\n- [FVM (Flutter Version Management)](https://fvm.app/documentation/getting-started/installation) - Required for managing Flutter versions\n- [Git](https://git-scm.com/)\n- [Xcode](https://developer.apple.com/xcode/) (for iOS development on macOS)\n- [Android Studio](https://developer.android.com/studio) (for Android development)\n\n\u003e **Note**: This project uses FVM for Flutter version management. You don't need to install Flutter globally.\n\n\u003e Optional: [VS Code](https://code.visualstudio.com/) or [Android Studio](https://developer.android.com/studio) with Flutter plugins for IDE support.\n\n---\n\n\u003ch2 id=\"installation\"\u003eInstallation \u0026 Setup\u003c/h2\u003e\n\n### 1. Clone the Repository (Template)\n\n```bash\ngit clone https://github.com/Victor-Zarzar/flutter_boilerplate.git my_app\ncd my_app\nflutter pub get\n```\n\n### 2. Open in your editor (example: Zed Editor)\n\n```bash\nzed .\n```\n\n### 3. Install Dependencies\n\n```bash\nflutter pub get\n```\n\n---\n\n\u003ch2 id=\"usage\"\u003eUsage\u003c/h2\u003e\n\n### Local Development\n\n#### Mobile (iOS Simulator)\n\n```bash\nmake run-ios\n```\n\n### Inspect Devtools\n\n```bash\ndart devtools\n```\n\n#### Web (Google Chrome)\n\n```bash\nmake run-chrome\n```\n\n#### Or Web Server default\n\n```bash\nmake run-web-server\n```\n\nAccess the application at `http://localhost:xxxx`\n\n---\n\n\u003ch2 id=\"development\"\u003eDevelopment\u003c/h2\u003e\n\n### Code Analysis\n\nCheck for code issues:\n\n```bash\nflutter analyze\n```\n\n### Testing\n\nRun all tests:\n\n```bash\nflutter test\n```\n\n### Format Code\n\nFormat all files:\n\n```bash\ndart format .\n```\n\n---\n\n\u003ch2 id=\"deployment\"\u003eDeployment\u003c/h2\u003e\n\n### Android (Google Play Store)\n\nBuild release APK:\n\n```bash\nflutter build apk --release\n```\n\nBuild release AppBundle:\n\n```bash\nflutter build appbundle --release\n```\n\nThe generated files will be at:\n\n- APK: `build/app/outputs/flutter-apk/app-release.apk`\n- AppBundle: `build/app/outputs/bundle/release/app-release.aab`\n\n### iOS (App Store)\n\n```bash\nflutter build ios --release\n```\n\nThe generated files will be at:\n\n- IPA: `build/ios/ipa/`\n\n### Web\n\n```bash\nflutter build web --release\n```\n\nThe generated files will be at: `build/web/`\n\n### With Sentry Monitoring\n\nFor all platforms, pass your DSN as an environment variable:\n\n```bash\nSENTRY_DSN=your-dsn-here flutter build apk --release\nSENTRY_DSN=your-dsn-here flutter build ios --release\nSENTRY_DSN=your-dsn-here flutter build web --release\n```\n\n### Sentry Configuration\n\nAll production builds include:\n\n- **Error tracking** with Sentry DSN\n- **Code obfuscation** for security\n- **Debug symbols** upload for crash symbolication\n\nMake sure to:\n\n1. Set your `SENTRY_DSN` from your Sentry project\n2. Upload debug symbols to Sentry after each release for proper stack traces\n3. Keep `build/debug-info/` directory for symbolication\n\n---\n\n\u003ch2 id=\"contributing\"\u003eContributing\u003c/h2\u003e\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n1. Fork the project\n2. Create your feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n---\n\n\u003ch2 id=\"license\"\u003eLicense\u003c/h2\u003e\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n\u003ch2 id=\"contact\"\u003eContact\u003c/h2\u003e\n\nVictor Zarzar - [@Victor-Zarzar](https://github.com/Victor-Zarzar)\n\nProject Link: [https://github.com/Victor-Zarzar/flutter_boilerplate](https://github.com/Victor-Zarzar/flutter_boilerplate)\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvictor-zarzar%2Fflutter_boilerplate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvictor-zarzar%2Fflutter_boilerplate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvictor-zarzar%2Fflutter_boilerplate/lists"}