@otjs/firebase-ace

Description

Real-time collaborative editor with out of the box binding with Firebase and Ace Editor.

Installation

• To install using Pnpm (recommended):

  pnpm add @otjs/ace

• To install using Yarn:

  yarn add @otjs/firebase-ace

• To install using Npm:

  npm i @otjs/firebase-ace --save

Peer Dependencies

Make sure to install all the peer dependencies beforehand:

Usage

import { FireAceEditor } from "@otjs/firebase-ace";

const fireAce = new FireAceEditor({
  databaseRef:            // Database Reference in Firebase Realtime DB
  editor:                 // Ace Editor instance
  announcementDuration:   // Duration to hide Cursor tooltip (optional)
  userId:                 // Unique Identifier for current user
  userColor:              // Unique Color Code for current user
  userName:               // Human readable Name or Short Name (optional)
});

Note: An API documentation will be shipped along with the package. This will power intellisense in the editor of your choice.

Testing

We are using Jest to form our Unit Test Suite. Nyc (formerly known as Istanbul) is used for coverage reporting.

To run all the unit test suites in local dev environment, run the following after dependencies have been installed:

yarn test

Reporting a Bug

Head on to Discussion section to report a bug or to ask for any feature. Use this template to make it structural and helpful for the maintainer and the contributors. Feel to add your queries about using this library as well under Q & A section of it. Remember, do not create any Issues by yourself, maintainers of this repository will open one if deemed necessary.

Contributing

See Contributing Guidelines.

License

This project is licensed under the terms of the MIT license, see LICENSE for more details.