KeyFlow 🔐

KeyFlow is a secure, open-source password manager browser extension that keeps your passwords safe with local encryption. Built with modern web technologies and designed with security in mind.

✨ Features

🔐
Local Encryption - All passwords encrypted locally, never sent to servers
🔑
Strong Password Generation - Generate secure passwords with customizable options
🚀
Auto-Fill Forms - Seamlessly fill login forms with saved credentials
🛡️
Zero-Knowledge - Your data never leaves your device
🔍
Secure Search - Find passwords quickly with encrypted search
📱
Cross-Platform - Works on Chrome, Firefox, and Edge

🚀 Quick Start

Option 1: Install from Chrome Web Store (Recommended)

For most users who want the easiest installation

  1. Visit the Chrome Web Store
    • Go to the KeyFlow page on Chrome Web Store
    • Click "Add to Chrome"
    • Confirm the installation
  2. Set Up Your Master Password
    • Click the KeyFlow icon in your browser toolbar
    • Create a strong master password
    • Start adding your passwords!

Option 2: Install from GitHub Releases

For users who want the latest version directly from GitHub

  1. Download the Extension
    • Go to GitHub Releases
    • Download the latest release ZIP file for your browser
    • Extract the ZIP file to a folder on your computer
  2. Install in Your Browser
    • Chrome: Go to chrome://extensions/, enable "Developer mode", click "Load unpacked", select the extracted folder
    • Firefox: Go to about:addons, click the gear icon, select "Debug Add-ons", click "Load Temporary Add-on", select manifest.json from the extracted folder
    • Edge: Go to edge://extensions/, enable "Developer mode", click "Load unpacked", select the extracted folder

Option 3: Build from Source

For developers and users who want the latest development version

  1. Clone the Repository 
    git clone https://github.com/novasuitelabs/keyflow.git
cd keyflow
  2. Install Dependencies 
    npm install
  3. Build the Extension 
    npm run build:extension
  4. Install in Your Browser
    • Follow the installation instructions above
    • Select the dist folder as the extension directory

🛡️ Security

KeyFlow prioritizes your security with multiple layers of protection:

Data Protection

  • Local Storage: All data stored locally in your browser
  • Strong Encryption: AES-256 encryption for all sensitive data
  • Zero-Knowledge: No data ever leaves your device
  • Secure Random: Cryptographically secure random number generation

Privacy Features

  • No Tracking: No analytics or tracking code
  • No Cloud: No cloud storage or synchronization
  • No Logging: No sensitive data is logged
  • Open Source: Transparent code for security review

🛠️ Development

Prerequisites

  • Node.js 18.x or higher
  • npm or yarn
  • Git
  • Modern browser (Chrome, Firefox, Edge)

Building from Source

  1. Clone the Repository 
    git clone https://github.com/novasuitelabs/keyflow.git
cd keyflow
  2. Install Dependencies 
    npm install
  3. Start Development Server 
    npm run dev
  4. Build Extension 
    npm run build:extension

Development Scripts

npm run dev          # Start development server
npm run build        # Build for production
npm run build:extension # Build extension files
npm run build:store  # Build extension and create Chrome Web Store ZIP
npm run lint         # Run ESLint
npm run preview      # Preview production build

🤝 Contributing

We welcome contributions from the community! Here's how you can help:

Ways to Contribute

  • 🐛 Report Bugs - Use the bug report template
  • 💡 Suggest Features - Use the feature request template
  • 🔧 Fix Issues - Pick an issue and submit a pull request
  • 📝 Improve Documentation - Help make our docs better
  • 🔒 Security Review - Review code for security issues

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🔗 Links

Made with ❤️ by Nova Suite Labs
Keep your passwords secure, keep them local, keep them with KeyFlow.