Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Collaborative Text Editor Powered by Firebase
Branch: master
Pull request Compare This branch is 174 commits behind firebase:master.

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
dist
examples
font
lib
test
.gitignore
Gruntfile.js
LICENSE
README.md
bower.json
package.json

README.md

Visit firepad.io for demo, examples, and embedding docs!

Join our Firepad Google Group to ask questions, request features, or share your Firepad apps with the community.

Read on if you'd like to contribute to Firepad.

Setting Up Your Environment

Firepad uses grunt to automate some build tasks (generating / minifying firepad.js, etc.). So before you get started, you'll need node.js installed. Then you can simply clone the repo, install the necessary node modules, and run grunt:

git clone https://github.com/firebase/firepad.git
cd firepad
npm install
sudo npm install -g grunt-cli
grunt

Source Code

To get started, here are some highlights of the directory structure and notable source files:

  • build/ - output directory for all files generated by grunt (firepad.js, firepad-min.js, firepad.zip, etc.).
  • examples - examples of embedding Firepad.
  • lib/
    • firepad.js - Entry point for Firepad.
    • text-operation.js, client.js - Heart of the Operation Transformation implementation. Based on ot.js but extended to allow arbitrary attributes on text (for representing rich-text).
    • annotation-list.js - A data model for representing annotations on text (i.e. spans of text with a particular set of attributes).
    • rich-text-codemirror.js - Uses AnnotationList to track annotations on the text and maintain the appropriate set of markers on a CodeMirror instance.
    • firebase-adapter.js - handles integration with Firebase (appending operations, triggering retries, presence, etc.).
  • test/ - Jasmine tests for Firepad (many of these were borrowed from ot.js).
Something went wrong with that request. Please try again.