Unisphere Dev

Local development server for the Unisphere ecosystem. Discover, inspect, and manage Unisphere experience repositories on your machine.

Installation

npx @unisphere/dev@latest

The server will start and automatically open in your browser.

Features

🔍 Experience Discovery

• Automatically discovers Unisphere experience repositories in your workspace
• Displays key information: workspace version, git branch, artifact counts
• Search and filter experiences
• Click to open in VS Code or view on GitHub

📊 Dependency Graph

• Visual representation of connections between experiences
• Shows package dependencies and runtime connections (via -types packages)
• Interactive graph with clickable nodes

📦 Artifact Details

• Comprehensive view of runtimes, applications, and packages
• Distribution information (npm, jfrog, unisphere, private)
• Direct links to npm packages
• GitHub tag information

🔄 Git Integration

• Displays current branch and last commit
• Sync status with remote (ahead/behind tracking)
• Clickable commit hashes linking to GitHub

📝 Release Notes

• Built-in release notes system
• Auto-shows new releases on startup
• "What's New" sidebar with badge for unseen releases

⚡ Version Check

• Hourly checks for new @unisphere/dev versions
• Persistent banner when updates are available
• One-click update command

First Run

On first launch, you'll be prompted to configure your base folder. This is the parent directory containing your unisphere-* repositories.

Example structure:

~/dev/unisphere/
├── unisphere-genie/
├── unisphere-chat/
└── unisphere-avatar/

Point the tool to ~/dev/unisphere/ and it will discover all experiences automatically.

Requirements

• Node.js: >= 18
• OS: macOS, Linux, Windows
• Viewport: Tablet size or larger (768px+)

Development

# Install dependencies
npm install

# Run development mode (server + client with hot reload)
npm run dev

# Build for production
npm run build

# Start production server
npm start

Configuration

Configuration is stored in ~/.unisphere-dev/config.json.

You can change your base folder anytime by clicking the Settings button in the sidebar.

Repository Discovery

The tool discovers repositories by:

1. Scanning the base folder for directories starting with unisphere-
2. Checking for a .unisphere file in the root
3. Reading repository metadata, git information, and artifact structure

Package Publishing

This project uses changesets for version management.

# Add a changeset (describe your changes)
npm run changeset

# Version packages (updates version based on changesets)
npm run version

# Publish to npm
npm run release

License

MIT

Links

• GitHub Repository
• npm Package
• Issues