Skip to content

Koushith/vortex

Repository files navigation

Vortex - Spatial Browser & Infinite Canvas for Visual Research

Vortex - Spatial Browser Chrome Extension

The infinite canvas browser for visual thinkers. Escape tab chaos forever.

Download Vortex Chrome Extension

Chrome Extension Manifest V3 React 18 MIT License Privacy First

Vortex Spatial Browser - Infinite Canvas with Connected Website Nodes


Vortex is a free, open-source Chrome extension that transforms your browser into an infinite spatial canvas. Websites become draggable, resizable nodes. Links create visual connections. Your research path is always visible.

Perfect for: Researchers, students, designers, writers, and anyone who thinks visually and is tired of tab overload.


📥 Installation

Quick Install (Users)

  1. ⬇️ Download vortex-extension.zip

  2. Unzip the downloaded file — you'll see a dist folder inside

  3. Open Chrome and go to chrome://extensions

  4. Enable "Developer mode" (toggle in top-right corner)

  5. Click "Load unpacked" and select the dist folder

  6. Done! Click the Vortex icon in your toolbar to start.

Installation Guide


Build from Source (Developers)

# 1. Clone the repo
git clone https://github.com/Koushith/vortex.git
cd vortex

# 2. Install dependencies
npm install

# 3. Build the extension
npm run build

# 4. Load the extension
# Go to chrome://extensions → Enable Developer mode → Load unpacked → Select the `dist` folder

Development Mode

# Run with hot reload
npm run dev

🚀 How to Use

  1. Click the Vortex icon in your browser toolbar
  2. Click "Open Canvas" to enter your spatial workspace
  3. Use + Page or press ⌘K to add websites
  4. Click links inside nodes — they open as connected child nodes
  5. Drag nodes to arrange your workspace

Pro tip: Click "Import Tabs" to convert all your open tabs into canvas nodes!


✨ Features

Feature Description
Infinite Canvas Pan and zoom freely across your workspace
Visual Browsing Websites as interactive, resizable nodes
Smart Connections Links auto-connect to show your research path
Sticky Notes Attach notes to nodes — they move together
Color Coding Organize with 7 color options
Layer Panel Figma-style sidebar showing all pages
Minimap Navigate large workspaces easily
Dark Mode Easy on the eyes
Auto-Save Your workspace persists automatically

⌨️ Keyboard Shortcuts

Action Shortcut
Quick Add URL ⌘K
Search Nodes ⌘F
Pan Canvas Space + Drag
Zoom ⌘+ / ⌘- or Scroll
Fit All in View ⌘1
Reset Zoom ⌘0
Duplicate Node ⌘D
Delete Node Delete / Backspace
Connect Nodes Shift + Click
Focus Node Double-click
Context Menu Right-click

🛠 Tech Stack

  • React 18 — UI framework
  • Vite — Build tool
  • Chrome Extension Manifest V3 — Extension architecture
  • Chrome Storage API — Local persistence

📁 Project Structure

vortex/
├── public/
│   ├── manifest.json       # Extension manifest
│   ├── background.js       # Service worker
│   ├── content-script.js   # Page injection
│   └── icons/              # Extension icons
├── src/
│   ├── App.jsx             # Main application
│   ├── components/
│   │   ├── Canvas.jsx      # Infinite canvas
│   │   ├── Node.jsx        # Website node
│   │   ├── Sidebar.jsx     # Layer panel
│   │   ├── Minimap.jsx     # Navigation minimap
│   │   └── StickyNote.jsx  # Note component
│   └── index.css           # Styles
├── dist/                   # Built extension (load this in Chrome)
└── package.json

🗺️ Roadmap

  • Memory management — Auto-suspend inactive nodes, LRU eviction, viewport-based loading
  • Multiple workspaces — Switch between different research contexts
  • Collaboration — Share workspaces with others
  • AI summarization — Quick summaries of page content
  • Cross-device sync — Access your canvas anywhere

🤝 Contributing

Contributions are welcome!

  1. Fork the repository
  2. Create your feature branch: git checkout -b feature/awesome-feature
  3. Commit your changes: git commit -m 'Add awesome feature'
  4. Push to the branch: git push origin feature/awesome-feature
  5. Open a Pull Request

📄 License

MIT License — see LICENSE for details.


👨‍💻 Author

Built by Koushith

TwitterGitHub


If you find Vortex useful, give it a ⭐ on GitHub!

About

Spatial browser extension - browse the web on an infinite canvas with connected nodes

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published