GoGo

A browser extension that lets you create custom shortcuts to your favorite websites.

---

What is GoGo?

GoGo transforms your browser's address bar into a powerful shortcut engine (its like VIM, but for your browser). Type go + space + your-shortcut to instantly navigate to any URL you've saved. No needs to click for your bookmarks !

---

Quick Start

1. Install the extension (see Installation below)
2. Create your first shortcut
   • Example: gmail → https://mail.google.com
3. Use it! Type go gmail in your address bar
4. Press Enter and you're there!

Example Shortcuts

go gmail     → https://mail.google.com
go gh        → https://github.com
go drive     → https://drive.google.com
go ty   → https://youtube.com
go red    → https://reddit.com

---

Screenshots

Create New Shortcuts

Manage Your Shortcuts

---

Installation

Chrome / Edge / Brave

Option 1: Chrome Web Store (Recommended)

🔗 Install from Chrome Web Store

Option 2: Manual Installation

1. Download the latest release
2. Extract the gogo-chrome ZIP file
3. Open chrome://extensions/ in your browser
4. Enable Developer mode (toggle in top-right corner)
5. Click Load unpacked
6. Select the gogo-chrome folder
7. Done! 🎉

Firefox

Option 1: Firefox Add-ons (Recommended)

🔗 Install from Firefox Add-ons

Option 2: Manual Installation

1. Download gogo-firefox.xpi from the latest release
2. Drag and drop the .xpi file into your Firefox window
3. Click Add when prompted
4. That's it! ✅

The Firefox extension is officially signed by Mozilla! No configuration changes needed!

---

Development

Prerequisites

• Node.js (only to build)
• npm or yarn or pnpm (only to build)
• Git

Setup

# Clone the repository
git clone https://github.com/Axthauvin/gogo.git
cd gogo

# Install dependencies
npm install

# Build for all browsers
npm run build

Project Structure

gogo/
├── .github/workflows/        # CI/CD automation and GitHub Actions
└── src/
    ├── background/           # Background scripts for extension lifecycle
    ├── core/                 # Core functionality (storage, constants, browser APIs)
    ├── icons/                # Extension icons and assets
    │   └── socials/          # Social media icons
    ├── modules/              # Feature modules
    │   ├── import-export/    # Import/export shortcuts functionality
    │   ├── search/           # Search and filtering logic
    │   ├── shortcuts/        # Shortcut management (CRUD operations)
    │   └── theme/            # Theme switching and customization
    ├── pages/                # Extension pages (popup, settings, onboarding)
    ├── styles/               # Global styles and CSS variables
    ├── ui/                   # UI components and forms
    │   ├── components/       # Reusable UI components
    │   └── forms/            # Form components and validation
    └── utils/                # Helper functions and utilities

Build Commands

# Build for all browsers
node build.js all

# Build for Chrome only
node build.js chrome

# Build for Firefox only
node build.js firefox

Testing Locally

Chrome/Edge/Brave:

1. Run node build.js chrome
2. Open chrome://extensions/
3. Enable Developer mode
4. Click "Load unpacked" and select dist-chrome

Firefox:

1. Run node build.js firefox
2. Open about:debugging#/runtime/this-firefox
3. Click "Load Temporary Add-on"
4. Select any file in dist-firefox

---

Contributing

Contributions are welcome! Whether it's bug reports, feature requests, or code contributions, all help is appreciated.

How to Contribute

1. Fork the repository
2. Create a feature branch

   git checkout -b feature/amazing-feature

3. Make your changes
4. Commit with clear messages

   git commit -m "Add amazing feature"

5. Push to your fork

   git push origin feature/amazing-feature

6. Open a Pull Request

Reporting Bugs

Found a bug? Please open an issue with:

Feature Requests

Have an idea? Open an issue and describe:

• The problem you're trying to solve
• Your proposed solution
• Why it would be useful

---

📝 Roadmap

• Publish to Chrome Web Store
• Publish to Firefox Add-ons
• Export/Import shortcuts
• Dark theme
• Search accross the shortcuts
• Sync shortcuts across devices
• Shortcut categories/tags
• Usage statistics

---

📄 License

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

---

❤️ Support

If you find GoGo useful, please consider:

• Starring the repository ⭐
• Reporting bugs
• Suggesting features
• Contributing code
• Sharing with friends

---

Made with ❤️ by @axthauvin

Install Now • Report Bug • Request Feature