{"id":35174534,"url":"https://github.com/bniladridas/browser","last_synced_at":"2026-05-20T07:14:49.752Z","repository":{"id":326843937,"uuid":"1106051517","full_name":"bniladridas/browser","owner":"bniladridas","description":"🍎","archived":false,"fork":false,"pushed_at":"2026-05-06T22:39:20.000Z","size":11030,"stargazers_count":1,"open_issues_count":1,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-07T00:28:27.454Z","etag":null,"topics":["browser","macos"],"latest_commit_sha":null,"homepage":"https://bniladridas.github.io/browser/","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bniladridas.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-11-28T14:51:56.000Z","updated_at":"2026-05-06T22:39:15.000Z","dependencies_parsed_at":null,"dependency_job_id":"89227fb3-0596-45c3-a7f3-e9abe66d9741","html_url":"https://github.com/bniladridas/browser","commit_stats":null,"previous_names":["bniladridas/browser"],"tags_count":118,"template":false,"template_full_name":null,"purl":"pkg:github/bniladridas/browser","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bniladridas%2Fbrowser","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bniladridas%2Fbrowser/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bniladridas%2Fbrowser/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bniladridas%2Fbrowser/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bniladridas","download_url":"https://codeload.github.com/bniladridas/browser/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bniladridas%2Fbrowser/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32736582,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-07T02:14:30.463Z","status":"ssl_error","status_checked_at":"2026-05-07T02:14:29.405Z","response_time":62,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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":["browser","macos"],"created_at":"2025-12-28T21:53:52.912Z","updated_at":"2026-05-07T12:02:07.259Z","avatar_url":"https://github.com/bniladridas.png","language":"Dart","funding_links":[],"categories":[],"sub_categories":[],"readme":"| **`CI`** | **`Flutter`** |\n|:--------- |:------------ |\n| [![Lint](https://github.com/bniladridas/browser/actions/workflows/lint.yml/badge.svg)](https://github.com/bniladridas/browser/actions/workflows/lint.yml) | [![Flutter](https://github.com/bniladridas/browser/actions/workflows/flutter.yml/badge.svg)](https://github.com/bniladridas/browser/actions/workflows/flutter.yml) |\n\n# Browser\n\n![Screenshot](assets/screenshot.png)\n\nFlutter desktop web browser with tabs, bookmarks, history, and encrypted settings storage. One codebase covers macOS, Windows, Linux, and platform-specific Firebase integrations.\n\n## Quick start\n\nClone the repo, install dependencies, and launch the macOS bundle.\n\n```bash\ngit clone https://github.com/bniladridas/browser.git\ncd browser\nflutter pub get\ncp .env.example .env  # populate Firebase values before running\nflutterfire configure --platforms macos\ngit checkout -- lib/firebase_options.dart  # keep runtime env vars\nflutter run -d macos\n```\n\nDo not commit `.env`; it contains private Firebase keys.\n\n## Firebase configuration\n\nAll Firebase values live in `.env`. The app expects the variables at runtime so the generated `lib/firebase_options.dart` remains under version control and references `const String` placeholders.\n\n\u003cdetails\u003e\n\u003csummary\u003eTo regenerate platform files after changing Firebase config\u003c/summary\u003e\n\n1. Update `.env` with the new Firebase project credentials.\n2. Run `flutterfire configure --platforms macos` to refresh the generated files.\n3. Immediately run `git checkout -- lib/firebase_options.dart` to revert the generated file back to the version that references environment variables.\n4. Restart `flutter run` to pick up the new settings.\n\nmacOS additionally requires `macos/Runner/GoogleService-Info.plist`; `flutterfire configure` creates it automatically, or copy it from your Firebase console. Confirm the plist lives next to the generated macOS runner, and keep `.env.example` as a template for local copies so you can safely generate new `.env` files with valid credentials.\n\n\u003c/details\u003e\n\n## Development\n\n- Requires Flutter \u003e=3.0.0 and the desktop toolchains for the target platforms.\n- Run `./check.sh` to apply formatting, lint, and build checks shared across platforms.\n- Build the signed macOS app with `flutter build macos` and adjust profiles with Xcode if needed.\n- If you hit missing Firebase credentials while targeting macOS, double-check that `.env` is populated before launching the app.\n\n## Keyboard shortcuts\n\nKeys are defined in `lib/utils/keyboard_utils.dart` with platform-neutral aliases.\n\n| Key | Action |\n| --- | ------ |\n| `[` / `LogicalKeyboardKey.bracketLeft` | Move to the previous tab |\n| `]` / `LogicalKeyboardKey.bracketRight` | Advance to the next tab |\n| `Left Arrow` / `LogicalKeyboardKey.arrowLeft` | Navigate backwards in history |\n| `Right Arrow` / `LogicalKeyboardKey.arrowRight` | Navigate forwards in history |\n| `R` / `LogicalKeyboardKey.keyR` | Reload the current tab |\n| `T` / `LogicalKeyboardKey.keyT` | Open a new tab |\n| `Escape` / `LogicalKeyboardKey.escape` | Close dialogs or stop loading |\n| `Tab` / `LogicalKeyboardKey.tab` | Focus the address bar or tool strip |\n\nModifier keys include `Meta` (Cmd on macOS), `Control`, `Alt`, and `Shift`.\n\n## macOS unsigned installs (no paid Developer ID)\n\nUnsigned builds trigger Gatekeeper warnings. The first launch steps keep the workflow entirely within the Finder UI:\n\n1. Drag `browser.app` to **Applications**.\n2. Right-click `browser.app`, choose **Open**, and confirm the dialog.\n3. Alternatively, open **System Settings → Privacy \u0026 Security** and click **Open Anyway** for `browser.app`.\n\nFor automation, bypass Gatekeeper for the binary with:\n\n```bash\nxattr -rd com.apple.quarantine /Applications/browser.app\n```\n\nOnly run the command if you trust the build source.\n\n## Need help?\n\n- `docs/` contains tutorials, architecture notes, and troubleshooting guides.\n- `.codex/README.md` documents toolchains, skills, and local workflows.\n- Report bugs or feature requests via [GitHub Issues](https://github.com/bniladridas/browser/issues).\n\n## Generated files\n\n`.gitattributes` marks generated files so GitHub hides them from diffs and stats. Common generated paths include:\n\n- `build/**` and `.dart_tool/**`\n- `lib/**/*.freezed.dart` and `lib/**/*.g.dart`\n- Platform artifacts such as `android/**`, `ios/**`, `macos/**`, `linux/**`, and `windows/**`\n\nWhen a specific file should be shown in diffs, add `-linguist-generated` to `.gitattributes` for that path.\n\n## Contribute\n\nFork, create a branch, run the checks, then open a pull request with a descriptive conventional commit-style summary. Follow repository tooling (`./check.sh`, GitHub Actions) before submitting.\n\n## License\n\nThis project is proprietary. See `LICENSE` for the full terms.\n\nCopyright (c) 2026 Niladri Das (bniladridas). All Rights Reserved.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbniladridas%2Fbrowser","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbniladridas%2Fbrowser","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbniladridas%2Fbrowser/lists"}