{"id":19519014,"url":"https://github.com/bizz84/flutter_ship_app","last_synced_at":"2025-03-27T00:13:04.891Z","repository":{"id":247928042,"uuid":"791364087","full_name":"bizz84/flutter_ship_app","owner":"bizz84","description":"Companion app for the Flutter in Production course","archived":false,"fork":false,"pushed_at":"2025-03-14T14:16:13.000Z","size":5188,"stargazers_count":57,"open_issues_count":2,"forks_count":17,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-24T02:44:29.061Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/bizz84.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","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}},"created_at":"2024-04-24T15:28:39.000Z","updated_at":"2025-03-14T14:15:41.000Z","dependencies_parsed_at":"2024-08-05T13:03:14.752Z","dependency_job_id":"fe94eb9c-704d-4598-a390-4aaab99c4429","html_url":"https://github.com/bizz84/flutter_ship_app","commit_stats":null,"previous_names":["bizz84/flutter_ship_app"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bizz84%2Fflutter_ship_app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bizz84%2Fflutter_ship_app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bizz84%2Fflutter_ship_app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bizz84%2Fflutter_ship_app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bizz84","download_url":"https://codeload.github.com/bizz84/flutter_ship_app/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245755678,"owners_count":20667027,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":[],"created_at":"2024-11-11T00:15:51.774Z","updated_at":"2025-03-27T00:13:04.881Z","avatar_url":"https://github.com/bizz84.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Flutter Ship App\n\nThis is the companion app for my course about Flutter in production.\n\nYou can preview the app here:\n\n- [Flutter Ship App - web demo](https://bizz84.github.io/flutter_ship_app_web/)\n\n## Cloning the repo\n\n```zsh\ngit clone https://github.com/bizz84/flutter_ship_app\ncd flutter_ship_app\nflutter pub get\n```\n\nOn certain lessons, I’ll ask you to checkout a specific branch so you can easily switch to the latest code. Example:\n\n```zsh\ngit switch m05-starter\n```\n\n### Multiple flavors\n\nThe app uses three separate flavors: `dev`, `stg`, and `prod`. These are already configured if you grab the latest code.\n\n### Configuring Firebase with FlutterFire CLI\n\nThe project uses Firebase Analytics and Remote Config. As such, it needs to be configured with the FlutterFire CLI as shown in [this lesson](https://pro.codewithandrea.com/flutter-in-production/03-flavors/18-firebase-setup-flutterfire-cli).\n\nTo make life easier, run this:\n\n```zsh\n# flutterfire-config.sh is gitignored\ncp flutterfire-config-template.sh flutterfire-config.sh\n```\n\nThen, edit the `flutterfire-config.sh` file to set the correct Firebase project ID for each flavor (Firebase project IDs are globally unique).\n\nFinally, run the `flutterfire-config.sh` script for each flavor:\n\n```zsh\n./flutterfire-config.sh dev\n# Follow steps in interactive prompt\n./flutterfire-config.sh stg\n# Follow steps in interactive prompt\n./flutterfire-config.sh prod\n# Follow steps in interactive prompt\n```\n\n### Setting the Sentry and Mixpanel keys\n\nThis project uses some `.env` files to store the Sentry and Mixpanel keys. Before you can run the app, create these empty files:\n\n- `.env.dev`\n- `.env.stg`\n- `.env.prod`\n\nUpon startup, the app will read the `SENTRY_DSN` and `MIXPANEL_PROJECT_TOKEN` from these files using `--dart-define-from-file`.\n\nIf those values are missing or empty, the app will still run, but won't be sending data to Sentry and Mixpanel.\n\nTo configure them correctly, you need to:\n\n- Create a Sentry project as [explained here](https://pro.codewithandrea.com/flutter-in-production/04-error-monitoring/03-sentry-installation)\n- Go to [sentry.io](https://sentry.io/) and grab the Sentry DSN from **[Project] \u003e Settings \u003e Client Keys**\n- Create a Mixpanel project **for each flavor** as [explained here](https://pro.codewithandrea.com/flutter-in-production/05-analytics/11-mixpanel-project-setup)\n- Go to the Access Keys section of the [project's settings page](https://mixpanel.com/settings/project/) and grab the Mixpanel project token\n\nThen, store the `SENTRY_DSN` and `MIXPANEL_PROJECT_TOKEN` inside `.env.dev`, `.env.stg`, `.env.prod`:\n\n```zsh\n# Go to sentry.io and grab the Sentry DSN from [Project] \u003e Settings \u003e Client Keys\nSENTRY_DSN=https://examplePublicKey@o0.ingest.us.sentry.io/your-dsn\n# Go to https://mixpanel.com/settings/project/ and grab the Mixpanel project token from the Access Keys section\nMIXPANEL_PROJECT_TOKEN=your-mixpanel-project-token-dev\n```\n\n### Setting the App Store ID\n\nIn order for the [force_update_helper](https://pub.dev/packages/force_update_helper) and [in_app_review](https://pub.dev/packages/in_app_review) packages to be correctly configured, the App Store ID should also be set in the `.env` files:\n\n```zsh\nAPP_STORE_ID=\u003capp-store-id\u003e\n```\n\nThis can be found on your app's page in App Store Connect under **General \u003e App Information \u003e Apple ID**.\n\nSee [this lesson](https://pro.codewithandrea.com/flutter-in-production/06-force-update/04-force-update-helper-package) for more info.\n\n### Note about Flutter Web\n\nTo make the app run on Flutter web, I followed some of the steps in [the Drift web guide](https://drift.simonbinder.eu/web/):\n\n- Include the `sqlite3.wasm` file from the [Sqlite3 releases page](https://github.com/simolus3/sqlite3.dart/releases)\n- Include the `drift_worker.js` file from the [Drift releases page](https://github.com/simolus3/drift/releases)\n- Used conditional imports in the [app_database.dart](lib/src/data/app_database.dart) file, following the same approach used by the [Drift example app](https://github.com/simolus3/drift/tree/develop/examples/app)\n\n### [LICENSE: MIT](LICENSE.md)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbizz84%2Fflutter_ship_app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbizz84%2Fflutter_ship_app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbizz84%2Fflutter_ship_app/lists"}