npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

documate

v2.0.3

Published

<p align="center"> <img width="100" src="https://raw.githubusercontent.com/bukharim96/documate/master/documate/public/favicons/android-icon-144x144.png" alt="Documate Logo" /> </p>

Downloads

11

Readme

Documate is a minimal static site generator that takes your Markdown-based code and outputs a whimsy React-ish site.

Short history

So we've been working on some Open Source projects and after all the struggles, we decided to have a website. Consequently, we needed to maintain the site somehow and we found it to be very clumsy and caused us a lot of maintainability issues. That aside, how could we possibly cater for different viewports? We thought of trying Docusaurus and/or other similar tools but they never met the standards of accessibility we needed.

Eventually, we decided to make a new static site generator that uses Bootstrap 4 (for the base layout), Create React App v2.1.2 (ejected) and bit of React's official site UI.

Why Markdown?

The reason for using Markdown is simply because docs written in HTML, JSX, Handlebars or any other markup that uses angle brackets seem to be cluttery with all the unnecessary tags that remove brevity and make readability a pain. Documate puts developer experience into consideration.

Another bonus of using Markdown is that any GitHub docs of your previous projects (in Markdown) can be put into a site with Documate.

All you need is to run two commands and then you deploy. Although Documate can't deploy your builds for you, your builds are made production-ready and your readers can enjoy reading along.

Features

  • Markdown-only - Access to full routes based on your folder layout is granted by default. These URLs trigger a helper function that fetches your docs on demand. You can embed HTML content in your Markdown files as usual. You can also link to HTML files which are fetched as stringified partials.
  • Code-Splitting - Your docs are made to load much more efficiently by using ES6 dynamic import() with webpack.
  • Minimal - Documate is not opinionated about how you lay out or format your docs. In any case, it knows how to transpile your Markdown/HTML 1-1 to HTML.
  • Responsive - Your site will look stunningly responsive and immersive across different viewports and will inherently get a React-ish feel.
  • Blazing fast serving - Run documate start and view your docs locally in no time. Check Documate's README.md for more details on dependency versions.
  • Production-ready builds - Your builds are minified and scripts uglified for good.

Documate doesn't generate docs or static content from code comments. Instead, you can copy and paste your code comments into Markdown with a few formattings and your docs should ready to get documated.

Made with ❤ by @bukharim96 and @undefinedbuddy. If you liked Documate, consider buying us a cup of coffee.