Here's a more professional and polished version of your README file for FlowForge:
FlowForge is a powerful Chrome extension that learns your browsing habits, suggests automations, and helps you perform repetitive web tasks with a single click.
- Automatically tracks step-by-step navigation patterns across websites.
- Identifies and groups repeated sequences into actionable "Flows".
- Ensures user privacy by storing all data locally on your device.
- Detects repeated flows (3+ occurrences) and offers to create shortcuts via prompt cards.
- Uses machine learning to identify similar—but not identical—patterns.
- Supports custom trigger conditions such as URL patterns and time of day.
- Provides a simple popup UI with icons, descriptions, and "Run" buttons.
- Automates multi-step tasks by sequentially loading pages and waiting for full load before continuing.
- Reduces manual effort for frequent tasks like report generation, data entry, or website monitoring.
- All Flow data is stored using
chrome.storage.local, with no external transmission. - Features include "Clear History" and an optional encryption setting.
- 100% local processing ensures maximum data privacy.
- Sync your Flows and settings across devices using Chrome’s Sync Storage API.
- Maintain a consistent experience and workflow regardless of which machine you're on.
- Includes improved reliability with cloud-backed storage enhancements.
(Link coming soon)
- Visit the Chrome Web Store page for FlowForge.
- Click Add to Chrome to install.
- Clone or download this repository.
- Open Chrome and navigate to
chrome://extensions/. - Enable Developer mode in the top-right corner.
- Click Load unpacked and select the root directory of FlowForge.
FlowForge runs in the background and automatically starts tracking your browsing patterns. A small badge in the bottom-right corner indicates when tracking is active.
- Automatic Detection: When a repeated browsing pattern is detected (3+ repetitions), FlowForge will suggest creating a Flow.
- Manual Creation: Click the FlowForge icon in your toolbar and select New Flow to define one manually.
- Click the FlowForge icon in your Chrome toolbar.
- View, search, and filter your saved Flows.
- Click Run to execute a Flow.
- Click the settings icon on a Flow card to rename, delete, or edit it.
Access the full settings panel via the extension popup:
- Flows: View and manage your saved Flows.
- Settings: Adjust extension behavior and preferences.
- Data Management: Export, import, encrypt, or clear your data.
- About: Version info and credits.
FlowForge is developed using:
- Manifest V3 for modern Chrome extension support.
- Background Service Worker for event-based flow detection and execution.
- Content Scripts to overlay UI elements and interact with web pages.
- Chrome Storage API (
localandsync) for data persistence.
FlowForge is designed with privacy at its core:
- No data is ever transmitted to external servers.
- All browsing and Flow data is stored locally.
- Users have full control over data, including encryption and deletion options.
We welcome contributions! If you'd like to improve FlowForge, feel free to:
- Submit a pull request
- Report issues
- Suggest new features
- Node.js v16+
- Chrome browser
npm install
npm test
npm run build
- Enhanced flow detection algorithms
- Cross-browser support (Firefox, Edge)
- Cloud sync backup option
- Mobile companion app
- Advanced scheduling options
- Team collaboration features
This project is licensed under the MIT License.