Need help with firepad?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

FirebaseExtended
3.5K Stars 829 Forks Other 524 Commits 72 Opened issues

Description

Collaborative Text Editor Powered by Firebase

Services available

!
?

Need anything else?

Contributors list

Firepad Actions Status Coverage Status Version

Firepad is an open-source, collaborative code and text editor. It is designed to be embedded inside larger web applications.

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

Status

Status: Frozen

This repository is no longer under active development. No new features will be added and issues are not actively triaged. Pull Requests which fix bugs are welcome and will be reviewed on a best-effort basis.

If you maintain a fork of this repository that you believe is healthier than the official version, we may consider recommending your fork. Please open a Pull Request if you believe that is the case.

Table of Contents

Getting Started With Firebase

Firepad requires Firebase in order to sync and store data. Firebase is a suite of integrated products designed to help you develop your app, grow your user base, and earn money. You can sign up here for a free account.

Live Demo

Visit firepad.io to see a live demo of Firepad in rich text mode, or the examples page to see it setup for collaborative code editing.

a screenshot of demo.firepad.io including a picture of two cats and a discussion about fonts

Downloading Firepad

Firepad uses Firebase as a backend, so it requires no server-side code. It can be added to any web app by including a few JavaScript files:

  
  
  
  

  
  
  

  
  
  

Then, you need to initialize the Firebase SDK and Firepad:

  

Documentation

Firepad supports rich text editing with CodeMirror and code editing via Ace. Check out the detailed setup instructions at firepad.io/docs.

Examples

You can find some Firepad examples here.

Contributing

If you'd like to contribute to Firepad, please first read through our contribution guidelines. Local setup instructions are available here.

Database Structure

How is the data structured in Firebase?

  • /
    - A unique hash generated when pushing a new item to Firebase.
    • users/
      • /
        - A unique hash that identifies each user.
        • cursor
          - The current location of the user's cursor.
        • color
          - The color of the user's cursor.
    • history/
      - The sequence of revisions that are automatically made as the document is edited.
      • /
        - A unique id that ranges from 'A0' onwards.
        • a
          - The user id that made the revision.
        • o/
          - Array of operations (eg TextOperation objects) that represent document changes.
        • t
          - Timestamp in milliseconds determined by the Firebase servers.
    • checkpoint/
      - Snapshot automatically created every 100 revisions.
      • a
        - The user id that triggered the checkpoint.
      • id
        - The latest revision at the time the checkpoint was taken.
      • o/
        - A representation of the document state at that time that includes styling and plaintext.

Repo Structure

Here are some highlights of the directory structure and notable source files:

  • dist/
    - output directory for all files generated by grunt (
    firepad.js
    ,
    firepad.min.js
    ,
    firepad.css
    ,
    firepad.eot
    ).
  • examples/
    - examples of embedding Firepad.
  • font/
    - icon font used for rich text toolbar.
  • 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).

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.