{"id":19658195,"url":"https://github.com/cdaringe/revealer","last_synced_at":"2026-02-06T13:49:15.268Z","repository":{"id":9991002,"uuid":"64026176","full_name":"cdaringe/revealer","owner":"cdaringe","description":"develop reveal.js presentations happily, without redundant source or boilerplate","archived":false,"fork":false,"pushed_at":"2024-07-24T05:18:41.000Z","size":936,"stargazers_count":15,"open_issues_count":12,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-17T20:09:42.341Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cdaringe.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-07-23T16:54:39.000Z","updated_at":"2021-02-12T20:09:59.000Z","dependencies_parsed_at":"2024-04-24T04:03:47.379Z","dependency_job_id":null,"html_url":"https://github.com/cdaringe/revealer","commit_stats":{"total_commits":52,"total_committers":5,"mean_commits":10.4,"dds":0.2692307692307693,"last_synced_commit":"c5cf99e164318f8fcdc882da3556e8760e4bd884"},"previous_names":[],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cdaringe%2Frevealer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cdaringe%2Frevealer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cdaringe%2Frevealer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cdaringe%2Frevealer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cdaringe","download_url":"https://codeload.github.com/cdaringe/revealer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244181233,"owners_count":20411601,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-11T15:36:25.470Z","updated_at":"2026-02-06T13:49:10.242Z","avatar_url":"https://github.com/cdaringe.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# revealer\n\n![](https://img.shields.io/badge/standardjs-%E2%9C%93-brightgreen.svg)\n\nthe fastest (and easiest!) way to build reveal.js presentations _without any boilerplate_.\n\n## usage\n\nto create and serve a new, hot-reloading presentation:\n\n- `npx revealer --start`\n\n:tada:!  that's it.  your presentation is now in `src/index.html`.  next consider adding some helpful npm scripts:\n\n```json\n{\n  \"scripts\": {\n    \"start\": \"revealer --start\",\n    \"build\": \"revealer --build [dest-dir]\"\n  }\n}\n```\n\nlet me use `revealer` programmatically you say.  no problem.  \u003cbig\u003e**official API docs live [here](https://cdaringe.github.io/revealer/)**\u003c/big\u003e\n\n## why\n\nstarting a reveal.js project should be as simple as `npm install reveal.js`, authoring some content, and hitting the go-button.  unfortunately, there's more to it.\n\nreveal.js is amazing.  however, when it's time to actually build a presentation, your choices to quickly scaffold a presentation are both less-than-ideal.  your two primary options to start building a presentation are either:\n\n1. clone and hack the reveal.js source, or\n1. use the npm package\n\nlet's discuss these strategies, then discuss `revealer`'s solution to the cons on both sides.\n\n### the ol' clone-n-hack\n\n**option #1**.  the reveal.js source code comes with a great set of rails.  it's packed with valuable css, plugins, and tooling to get your developing your presentation quickly (e.g. file server \u0026 live reload).  however, cloning a repo then modifying it isn't really a great way to use a _library_.  instead of consuming it as a library, you end up using it as a standalone application.  what are this strategy's weaknesses?\n\n1. what happens when you need upstream updates? merge conflicts are almost guaranteed, at some point.\n1. how does your presentation repository structure look? it looks like the reveal.js source code, not simply your precious presentation content.  this yields some degree of complication \u0026 misdirection.\n\nmany reveal.js projects choose this path.\n\n### consume the npm package\n\n**option #2**. `npm install reveal.js` _is a thing_.  you can install it as a dependency.  however, when done so, you no longer have rails.  the helpful reveal.js assets are still nested inside of `node_modules/reveal.js/...`, but you don't have a runable solution ready to go.  that is to say, the ease of developing a presentation suddenly becomes much more difficult.  you need to manually construct your page, your assets, and development workflow, vs. using those which reveal.js already provides for you. these bells and whistles don't need to be redesigned--reveal.js' workflow is just fine!  some projects, like [reveal-boilerplate](https://github.com/Retozi/reveal-boilerplate), do _rewire_ up a set of assets into a full presentation, BUT, is it worth reimplementing all of the reveal.js tooling again in your own project?  probably not!\n\n### give me the best of both worlds, please!\n\nhere's what we want:\n  - quick setup time for a reveal.js project\n  - to use reveal.js as a dependency, and permit rolling version updates\n  - to keep our project source looking like _just_ our source, not the reveal.js source\n  - to maintain ease of use, keeping the reveal.js rails intact.  that is, make  plugins/css/tooling that ship with reveal.js accessible\n\n**revealer achieves these goals**. specifically, it:\n\n  - installs `reveal.js`'s dev dependencies within the reveal.js dependency\n  - watches your `src` dir, and copies them into the `reveal.js` package src\n  - runs `reveal.js`'s server-watcher-browser-launcher tooling.\n  - onbuild, `revealer --build`, automatically merges your content with reveal.js' and outputs a runnable, static website!\n\n**you're left with a simple, beautiful folder structure**.  no cruft.  just your package.json and your presentation content!\n\n```\n$ tree -L 1\n.\n├── node_modules\n├── package.json\n└── src\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcdaringe%2Frevealer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcdaringe%2Frevealer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcdaringe%2Frevealer/lists"}