atom/teletype

Atom and all repositories under Atom will be archived on December 15, 2022. Learn more in our official announcement

Teletype for Atom

An Atom package that lets developers share their workspace with team members and collaborate on code in real time.

Learn more at teletype.atom.io.

Installation

Command Line

1. Install Atom 1.22 or newer

2. In the terminal, install the package via apm:

   apm install teletype
   

GUI

1. Install Atom 1.22 or newer
2. Launch Atom
3. Open Settings View using Cmd+, on macOS or Ctrl+, on other platforms
4. Click the Install tab on the left side
5. Enter teletype in the search box and press Enter
6. Click the "Install" button that appears

Hacking

This package is powered by three main components:

• teletype-crdt: The string-wise sequence CRDT that enables peer-to-peer collaborative editing.
• teletype-server: The server-side application that facilitates peer discovery.
• teletype-client: The editor-agnostic library that manages the interaction with other clients.

Dependencies

To run teletype tests locally, you'll first need to have:

• Atom 1.22 or later
• Node 7+
• PostgreSQL 9.x

Running locally

1. Clone and bootstrap

   git clone https://github.com/atom/teletype.git
   cd teletype
   createdb teletype-test
   apm install
   

2. Run the tests

   atom --test test