Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/TailorDev/monod

:notebook: Our cool, secure, and offline-first Markdown editor.
https://github.com/TailorDev/monod

markdown-editor offline-first secure

Last synced: 5 days ago
JSON representation

:notebook: Our cool, secure, and offline-first Markdown editor.

Host: GitHub
URL: https://github.com/TailorDev/monod
Owner: TailorDev
License: mit
Archived: true
Created: 2016-03-04T15:06:56.000Z (over 8 years ago)
Default Branch: master
Last Pushed: 2020-01-25T15:01:21.000Z (almost 5 years ago)
Last Synced: 2024-09-30T00:44:20.267Z (about 1 month ago)
Topics: markdown-editor, offline-first, secure
Language: JavaScript
Homepage: https://monod.lelab.tailordev.fr/
Size: 3.29 MB
Stars: 874
Watchers: 20
Forks: 61
Open Issues: 28
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

awesome-starred - TailorDev/monod - :notebook: Our cool, secure, and offline-first Markdown editor. (others)

README

        Monod

=====

[![Greenkeeper badge](https://badges.greenkeeper.io/TailorDev/monod.svg)](https://greenkeeper.io/)

[![Circle CI](https://circleci.com/gh/TailorDev/monod.svg?style=svg)](https://circleci.com/gh/TailorDev/monod)

![Build Status](https://saucelabs.com/browser-matrix/willdurand.svg)

---

## Hi! I'm Monod, the Markdown Editor!







**Monod** is a (relatively) **secure** and **offline-first** Markdown editor we

have built at TailorDev in order to learn

[React.js](https://facebook.github.io/react/) (and a bunch of other JavaScript

tools and libraries). We dedicated two **Le lab** sessions to build the

foundations of Monod:

* [Introducing Le lab with “Monod”, our Markdown

  Editor](https://tailordev.fr/blog/2016/03/11/introducing-le-lab-with-monod-our-markdown-editor/)

* [Le lab #2 — Offline-First, Document Sharing, Templates: Monod is Back (not in

  Black)](https://tailordev.fr/blog/2016/04/15/le-lab-2-offline-first-document-sharing-templates-monod-is-back/)

---

## Usage

Either use our public instance at: https://monod.lelab.tailordev.fr/, or

self-host Monod at home, on your server, or even on Heroku:

[![Deploy to

Heroku](https://www.herokucdn.com/deploy/button.png)](https://heroku.com/deploy)

## Documentation

Documentation can be found in the [`doc/`](doc/writing.md) directory.

## Installation

### Production

    $ git clone https://github.com/TailorDev/monod.git

    $ npm install # will run `npm run build`

    $ npm prune --production

We use this

[Dockerfile](https://github.com/TailorDev/dockerfiles/blob/master/node/Dockerfile)

to run Monod in production (which runs `npm run start` from the Monod root

directory).

### Development

    $ git clone https://github.com/TailorDev/monod.git

    $ npm install

    $ npm run dev

The last command runs the development server at

[`http://localhost:8080`](http://127.0.0.1:8080), and uses Hot Module

Replacement. You can override the default host and port through the env

variables `HOST` and `PORT`.

You can also start the server by running:

    $ MONOD_DATA_DIR=/path/to/data npm run start

`MONOD_DATA_DIR` is an environment variable that configures where the server

reads and writes Monod's data. It defaults to `./data/` (so be sure

to create that directory if you start the server with just `npm run start`).

You are all set!

### Other Commands

#### `npm run build`

Builds the client-side application in `build/` (production ready)

#### `npm run stats`

Webpack build + generate a JSON file with metrics. [We blogged about why this

can be useful](https://tailordev.fr/blog/2016/03/17/loading-dependencies-asynchronously-in-react-components/).

#### `npm run lint`

Runs [ESLint](http://eslint.org/).

#### `npm run lint:fix`

Fix all ESLint problems.

## Requirements

We use `node` 8.0+ and `npm` 5.0+.

## Contributing

Please, see the [CONTRIBUTING](CONTRIBUTING.md) file.

## Running the Tests

    $ npm run test

You can also "watch" them:

    $ npm run test:watch

Code coverage is available by running:

    $ npm run cov

## Contributor Code of Conduct

Please note that this project is released with a [Contributor Code of

Conduct](http://contributor-covenant.org/). By participating in this project you

agree to abide by its terms. See [CODE_OF_CONDUCT](CODE_OF_CONDUCT.md) file.

## License

Monod is released under the MIT License. See the bundled [LICENSE](LICENSE.md)

file for details.