node package manager
Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »



If you just want to quickly try out Idyll, we offer an online editor where you can play around and try out the language.

See for full documentation.

Join our chatroom on Gitter:

What is Idyll?

Idyll is a tool that makes it easier to author interactive narratives for the web. The goal of the project is to provide a friendly markup language — and an associated toolchain — that can be used to create dynamic, text-driven web pages.

Idyll helps you create documents that use common narrative techniques such as embedding interactive charts and graphs, responding to scroll events, and explorable explanations. Additionally, its readable syntax facilitates collaboration between writers, editors, designers, and programmers on complex projects.

In Idyll the entire document is reactive, built on top of Facebook's React framework. Changes immediately propagate through the entire page, taking the pain out of creating data-driven experiences that respond to reader input. You don't need to know anything about React to use Idyll, but if you do, it is easy to extend with your own custom components.


Full Articles

With Popular JavaScript Libraries

Other Examples


Contributing to Idyll

Idyll attempts to adhere to the open open source philosophy as much as reasonably possible. Pull requests are very welcome!

To submit a PR do the following:

  • Fork the repo and clone it onto to your computer.
  • Run yarn to install the dependencies. If you don't have yarn installed, see
  • Make your changes.
  • Make sure the tests pass by running npm test. If you add a feature, add a test for it.
  • Submit the PR!

If you have any questions, feel free to open an issue or inquire on