Skip to content

StephanRaab/vue-doxen

 
 

Repository files navigation

A doxen dog with the Vue logo on it's chest

vue-doxen

The world's best Vue.js component documentation tool!

  • Designed specifically to work with Vue 3 components (exclusively)
  • Fully customizable
  • All CSS is optional
  • Documentation lives in the component as code (or in separate object if preferred)
  • Vue-Doxen is just a Vue componet, so it works anywhere a Vue component would work.
  • Generates at runtime, so always up-to-date
  • Doesn't require adopting an entire ecosystem or installing tons of dependencies, just use what works with Vue and you're good.

Using the library

Go to the docs site for usage and installation steps:

Arrow pointing up to URL


Running this repo locally to make PRs

  1. Uninstall Node/npm/nvm/nvm-windows/n/nodist
  2. Install Volta (replaces all of the above and is much better)
  3. Clone the repo
  4. npm install
  5. npm run build builds both the docs site and library
  6. npm run lint checks for linting errors

Project Structure

  • Documentation site
    • npm start will launch the app for local development
    • Code lives in app folder
    • Uses vite.config.doc.js
    • npm run build will produce docs folder
  • Library
    • To manually test/develop the library use the docs site via npm start
    • Code lives in the lib folder
    • Uses vite.config.lib.js
    • npm run build will produce dist folder
    • npm t runs unit tests for the library

About

The world's best Vue.js component documentation tool

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Vue 48.4%
  • JavaScript 47.4%
  • Sass 2.4%
  • HTML 1.8%