lint | flutter |
|---|---|
 |  |
Flutter desktop browser with tabs, bookmarks, history, and encrypted settings storage. The app runs on macOS, Windows, and Linux.
Clone the repo, install dependencies, and launch the macOS bundle.
git clone https://github.com/bniladridas/browser.git
cd browser
flutter pub get
cp .env.example .env # populate Firebase values before running
flutterfire configure --platforms macos
git checkout -- lib/firebase_options.dart # keep runtime env vars
flutter run -d macosDo not commit .env; it contains private Firebase keys.
Firebase values are read from .env at runtime. The generated lib/firebase_options.dart stays under version control and references const String placeholders.
regenerate platform files after changing Firebase config
- Update
.envwith the new Firebase project credentials. - Run
flutterfire configure --platforms macosto refresh the generated files. - Run
git checkout -- lib/firebase_options.dartto keep the environment-variable version. - Restart
flutter runto pick up the new settings.
macOS also needs macos/Runner/GoogleService-Info.plist. flutterfire configure creates it, or you can copy it from the Firebase console. Keep .env.example as a template for local .env files.
- Requires Flutter 3.44.0 and the desktop toolchains for the target platforms.
- Run
./check.shto apply formatting, lint, and build checks shared across platforms. - Build the signed macOS app with
flutter build macosand adjust profiles with Xcode if needed. - If you hit missing Firebase credentials while targeting macOS, double-check that
.envis populated before launching the app.
Release 1.28.9 was the last desktop release published directly by GitHub Actions. Current workflow automation uses the browser-dart GitHub App where elevated repository access is needed, including release and project automation.
Keys are defined in lib/utils/keyboard_utils.dart.
| macOS | Windows/Linux | Action |
|---|---|---|
Cmd + [ | Alt + Left | Navigate backwards in history |
Cmd + ] | Alt + Right | Navigate forwards in history |
Cmd + R | Ctrl + R | Reload the current tab |
Cmd + T | Ctrl + T | Open a new tab |
Cmd + W | Ctrl + W | Close the current tab |
Cmd + F | Ctrl + F | Focus the address bar |
Cmd + Shift + F | Ctrl + Shift + F | Open the page font picker |
Cmd + Option + Left | Ctrl + Shift + Tab | Move to the previous tab |
Cmd + Option + Right | Ctrl + Tab | Move to the next tab |
Cmd + Enter | F11 | Toggle fullscreen |
Cmd + M | Meta + Down | Minimize the window |
Escape | Escape | Close dialogs or stop loading |
Unsigned builds can show Gatekeeper warnings. The first launch can stay in Finder:
- Drag
Browser.appto Applications. - Right-click
Browser.app, choose Open, and confirm the dialog. - Alternatively, open System Settings → Privacy & Security and click Open Anyway for
Browser.app.
For Terminal installs, clear the quarantine flag with:
xattr -rd com.apple.quarantine /Applications/Browser.appOnly run the command if you trust the build source.
docs/contains focused project notes..codex/README.mddocuments toolchains, skills, and local workflows.- Report bugs or feature requests via GitHub Issues.
.gitattributes marks generated files so GitHub hides them from diffs and stats. Common generated paths include:
build/**and.dart_tool/**lib/**/*.freezed.dartandlib/**/*.g.dart- Platform artifacts such as
android/**,ios/**,macos/**,linux/**, andwindows/**
When a specific file should be shown in diffs, add -linguist-generated to .gitattributes for that path.
Fork, create a branch, run the checks, then open a pull request with a short conventional commit-style summary.
This project is proprietary. See LICENSE for the full terms.
Copyright (c) 2026 Niladri Das (bniladridas). All Rights Reserved.