{"id":22009703,"url":"https://github.com/zitadel/zitadel_flutter","last_synced_at":"2025-05-06T18:15:43.076Z","repository":{"id":103222674,"uuid":"560750984","full_name":"zitadel/zitadel_flutter","owner":"zitadel","description":"This project is a starting point for a Flutter application with ZITADEL integration. It runs on Android, IOS and web","archived":false,"fork":false,"pushed_at":"2024-04-30T06:59:12.000Z","size":334,"stargazers_count":11,"open_issues_count":0,"forks_count":7,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-31T01:41:18.039Z","etag":null,"topics":["dart","examples","flutter","zitadel"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zitadel.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}},"created_at":"2022-11-02T07:20:02.000Z","updated_at":"2025-02-13T06:19:16.000Z","dependencies_parsed_at":"2024-11-30T02:10:33.922Z","dependency_job_id":"7e1c555d-7a7c-41dc-95da-48792a68dc25","html_url":"https://github.com/zitadel/zitadel_flutter","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zitadel%2Fzitadel_flutter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zitadel%2Fzitadel_flutter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zitadel%2Fzitadel_flutter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zitadel%2Fzitadel_flutter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zitadel","download_url":"https://codeload.github.com/zitadel/zitadel_flutter/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252741475,"owners_count":21797027,"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":["dart","examples","flutter","zitadel"],"created_at":"2024-11-30T02:10:31.377Z","updated_at":"2025-05-06T18:15:43.054Z","avatar_url":"https://github.com/zitadel.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# zitadel_flutter\n\nThis project is a starting point for a Flutter application with ZITADEL integration.\n\nIt uses [package:oidc](https://pub.dev/packages/oidc) to handle the user management logic.\n\n## Getting Started\n\nA few resources to get you started if this is your first Flutter project:\n\n- [Lab: Write your first Flutter app](https://docs.flutter.dev/get-started/codelab)\n- [Cookbook: Useful Flutter samples](https://docs.flutter.dev/cookbook)\n\nFor help getting started with Flutter development, view the\n[online documentation](https://docs.flutter.dev/), which offers tutorials,\nsamples, guidance on mobile development, and a full API reference.\n\n\n## Deploy your own\n\n[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fzitadel%2Fzitadel_flutter)\n\nTo deploy your page with vercel, go to settings (Build \u0026 Development Settings), then override your build command to (make sure to replace `[zitadel-url]` and `[zitadel-client-id]`):\n\n```bash\nflutter/bin/flutter build web --dart-define zitadel_url=[zitadel-url] --dart-define zitadel_client_id=[zitadel-client-id]\n```\n\noutput directory is\n\n```bash\nbuild/web\n```\n\ninstall command is\n\n```bash\nif cd flutter; then git pull \u0026\u0026 cd .. ; else git clone https://github.com/flutter/flutter.git; fi \u0026\u0026 ls \u0026\u0026 flutter/bin/flutter doctor \u0026\u0026 flutter/bin/flutter clean \u0026\u0026 flutter/bin/flutter config --enable-web\n```\n\nthen add your redirect uri in ZITADEL console. It should look like this `https://your-site.com/auth.html`.\n\n## ZITADEL configuration\n\n- Make sure to create a native application. \n- Add the redirects:\n  - mobile applications with your custom scheme (in our case `com.zitadel.zitadelflutter:/`) \n  - web redirect (in our case for local development `http://localhost:4444/auth.html`) and make sure to have enabled devMode.\n- To get a `refresh_token`, check the checkbox for Refresh Token and add the `offline_access` scope.\n\n## Run\n\n1. Copy your instance url and your `clientId` and set it in `lib/main.dart` to the `zitadelIssuer` and `zitadelClientId` variables.\n\n\n2. Search for every instance of `com.example.zitadelflutter` in the code and replace it with your app identifier (note that having underscore `_` in the callback schema is disallowed).\n\n    This exists in the following locations:\n    - android/app/build.gradle\n    - ios/Runner/Info.plist\n    - macos/Runner/Info.plist\n    - lib/main.dart\n\n### Web\n\nTo run this example in your browser, make sure to run it on port 4444.\n\n```bash\nflutter run -d chrome --web-port=4444 --dart-define zitadel_url=[zitadel-url] --dart-define zitadel_client_id=[zitadel-client-id]\n```\n\n### Further Development\n\nIf you want to access more features, and use this app on other platforms (e.g. desktop),\nMake sure to read the [package:oidc wiki](https://bdaya-dev.github.io/oidc/oidc-getting-started/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzitadel%2Fzitadel_flutter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzitadel%2Fzitadel_flutter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzitadel%2Fzitadel_flutter/lists"}