/flow-browser-v0

An experimental browser built on electron.

Primary LanguageTypeScriptGNU General Public License v3.0GPL-3.0

Flow Browser

A modern, tabbed web browser with Chrome extension support—built on Electron.

Flow Browser Logo

Overview

Flow Browser is a lightweight, feature-rich web browser that combines the power of Chromium with a clean, modern interface. Built on Electron, it offers full support for Chrome extensions, making it a versatile alternative to mainstream browsers.

Features

  • Modern UI: Clean, intuitive interface built with React 19 and Tailwind CSS
  • Tab Management: Efficient browsing with multi-tab support
  • Chrome Extension Support: Install and use extensions from the Chrome Web Store
  • Extension API Support: Compatible with most Chrome extension APIs
  • Manifest V3 Support: Ready for the latest extension standards

Packages

Name Description
shell The main browser application with tabbed interface
electron-chrome-extensions Adds Chrome extension API support to Electron
electron-chrome-context-menu Chrome-style context menu for the browser
electron-chrome-web-store Integration with the Chrome Web Store

Getting Started

# Clone the repository
git clone https://github.com/your-username/flow-browser.git
cd flow-browser

# Install dependencies and launch the browser
bun install
bun start

Using Extensions

From Chrome Web Store

  1. Navigate to the Chrome Web Store
  2. Browse and install extensions directly from the store

Local Extensions

To test local unpacked extensions:

  1. Place extension folders in the ./extensions directory
  2. Launch the browser to load them automatically

Development

# Build all packages
bun build

# Start
bun start

Technology Stack

  • Frontend: React 19, Tailwind CSS, Framer Motion
  • Routing: TanStack Router
  • Build Tools: Vite, TypeScript, Bun
  • Runtime: Electron 35 (Chromium)

License

This project is licensed under the GNU General Public License v3.0 (GPL-3.0) - see the LICENSE file for details.

Acknowledgements

Flow Browser is a fork of electron-browser-shell by Sam Maddock, with enhancements and modifications.