Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (vzcode) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

VZCode: Multiplayer Code Editor

VZCode offers a multiplayer code editing environment that caters to a real-time collaborative development experience.

VZCode Interface

Development
Features
Use Cases
Stack
Goals
Prior Work
Milestones
Team
Spaces

Development

Backlog & Issues: Use our Kanban Board to track the backlog, good first issues, and known bugs.
Local Setup:
```
cd vzcode
npm install
npm run test-interactive
```
For hot reloading (client-side only), run:
```
npm run dev
```
You can also use npm link to set up the vzcode NPM package in another project to point to your clone of the repository. This can be useful when testing out how vzcode functions as a dependency.

Features

Browser-based editing environment
Sidebar with file listings (directories support pending)
Real-time collaboration via LAN or using services like NGrok
File management through tabs
Basic file operations: create, rename, delete
Syntax highlighting for web languages
Interactive widgets for editing numbers (Alt+drag on numbers)
Auto-save, debounced after code changes
Auto-save, throttled while using interactive widgets to support hot reloading environments

Use Cases

Local Editor: Use VZCode like VSCode or Vim:

npm install -g vzcode
cd myProject
vzcode

Project-specific Editor: Embed VZCode within your project for developers who might not have a preferred IDE, or to provide an editing experience that seamlessly integrates with hot reloading.
```
{
  "name": "example-project",
  "scripts": {
    "edit": "vzcode"
  },
  "dependencies": {
    "vzcode": "^0.1.0"
  }
}
```
Run using npm run edit.

For example, as the editor of Vite D3 Template, which showcases the throttled auto-save behavior of VZCode while using the interactive widgets in the context of editing files served by the Vite dev server which supports hot reloading.
Hosting with Ngrok: Allow external collaborators to join your VZCode session.
- With Ngrok Globally Installed: (Requires authenticated Ngrok account)
```
vzcode
ngrok http 3030
```
- Through VZCode: Coming soon!
Staging Site Editor (Experimental): Use VZCode on a persistent server, making code changes with multiplayer mode remotely, reflecting instantly on a staging site.

Stack

Built using technologies such as:

Goals

The project aims to:

Offer a feasible alternative to VSCode + Live Share for frontend development
Facilitate easy project-specific IDE embedding
Enhance user experience with advanced features
Support instant feedback through hot reloading
Keep improving based on feedback
Serve as a core for VizHub's next-gen editor

Prior Work

VZCode is inspired by VizHub v2. VizHub V2's code editor supports real-time collaboration using older versions of libraries such as CodeMirror 5 and JSON0 OT. For VZCode, the aim is to leverage the latest technologies to deliver a more streamlined experience.

Prior Work Image

Milestones

For detailed progress, visit the VZCode Kanban Board

February 2023: Initial setup, server, and basic features
March 2023: Enhancements, UX improvements, and NPM release
April 2023: Directory support, feedback iterations, and promotion
May - August 2023: Themes, overhaul CSS, adopt TypeScript, interactive widgets
September 2023: Auto-run Prettier, AI-Assisted coding, TypeScript Autocomplete
October 2023: Draggable split pane, deep linking, presence enhancements
November 2023: Directory manipulation UX, implementing VSCode features

Team

Curran Kelleher
Anooj Pai from RPI RCOS

We welcome contributions!

vzcode