Skip to content

victorhuangwq/nexus

Repository files navigation

🌟 Nexus

✨ Type a task, Nexus builds the workspace ✨

⚠️ Work in Progress: This project is under active development. Features may change and bugs may exist.

Built with React Powered by Claude TypeScript Electron

A desktop command bar that turns any job into an instant, single-window workspace

🚀 Features📸 Demo⚡ Quick Start🛠️ Tech Stack🤝 Contributing


🎯 What is Nexus?

Nexus is a desktop command bar that turns any job-to-be-done ("plan a weekend in Kyoto," "track BTC/ETH," "export slides + email Alice") into an instant, single-window workspace. It embeds the right web apps, pre-filters them, and remembers your layout so you stop chasing menus and juggling tabs.

Nexus Homepage

Type. Generate. Use. It's that simple.

🚀 Features

🎨 Instant Workspace Creation

Type any task and get a perfectly configured workspace in seconds

🧠 Smart App Selection

AI understands your task and embeds the right web apps automatically

🖥️ Single-Window Focus

All your tools in one place. No more tab juggling or window chaos

⚡ Pre-Filtered Content

Apps open with the right context: search results, specific pages, relevant data

🎯 Layout Memory

Nexus remembers how you like your tools arranged for each type of task

🔧 Stop Menu Hunting

Direct access to what you need. No navigating through endless menus

📸 Demo

✨ See the Magic in Action

Kyoto Weekend Plan
✈️ "plan a weekend in Kyoto"
Complete itinerary with maps and weather
Crypto Trading Dashboard
💰 "track BTC/ETH"
Live crypto data with whale alerts
Physics Homework Toolkit
📐 "physics homework"
Calculator and formulas for high school physics
Weather Radar
🌤️ "weather in Sydney"
Live weather radar powered by Windy

⚡ Quick Start

Prerequisites

  • Node.js 16+
  • npm or yarn
  • Anthropic API key (Get one here) - Optional for demo

🚀 Installation

# Clone the magic ✨
git clone https://github.com/victorhuangwq/nexus.git
cd nexus

# Install dependencies 📦
npm install

# Set up your API key 🔑 (Optional - demo works without it)
cp .env.example .env
# Edit .env and add: ANTHROPIC_API_KEY=your_key_here

# Launch Nexus! 🎉
npm run dev

📚 Documentation

🎮 Development Commands

npm run dev          # 🚀 Start development server
npm run build        # 📦 Build for production
npm test             # 🧪 Run test suite
npm run lint         # 🔍 Lint codebase
npm run preview      # 👀 Preview production build

🏗️ Project Structure

nexus/
├── 📂 src/
│   ├── 🎨 components/    # React components
│   ├── 🧠 services/      # AI & business logic
│   ├── 🎯 hooks/         # Custom React hooks
│   └── 🖥️ main/          # Electron main process
├── 📂 public/            # Static assets
├── 📂 tests/             # Test files
└── 📄 package.json       # Project config

🤝 Contributing

We love contributions! Whether it's bug fixes, new features, or documentation improvements.

  1. Fork the repo
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

📝 License

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


🌟 Star us on GitHub!

Made with ❤️ by Victor Huang

⬆ back to top

About

Nexus: Type a task, Nexus builds the workspace

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published