Skip to content

Latest commit

 

History

History
52 lines (34 loc) · 2.23 KB

README.md

File metadata and controls

52 lines (34 loc) · 2.23 KB

candelabra

Candelabra Logo - Lit candles on a 6-prong candelabra glowing in the dark

What does Candelabra do?

Candelabra is a web crawler designed to generate a sitemap from an entry URL and audit each of its pages for semantic HTML and accessibility violations. Using Candelabra, you can check any website for accessibility violations. More importantly, you can point it to local servers and other developer environments to test your code before you deploy.

It works out of the box for any website that doesn't require authentication on entry. This means it can audit any JavaScript-rendered website including those built with the popular front-end frameworks: React, Vue, Ember, Angular, etc.

Want to read more about Candelabra? Check out the wiki.

How do I use Candelabra?

Candelabra was designed to require no configuration. Simply install the package and fire it up. For detailed usage, see Options.

# install the package
yarn global add candelabra

# run the utility
candelabra <entry-url>

Options

Flag Description
-V, --version output the version number
-o, --output file path to output JSON, defaults to displaying inline
-g, --groupBy SEVERITY / PAGE / RULE, defaults to SEVERITY
-l, --limit limit the number of URLs to crawl, defaults to 1000
-h, --help output usage information

Use candelabra -h for a current list of options while development continues.

Contributing

Simply clone the repository and get to work! Create pull requests against the repository to merge code in.

# clone the repo
git clone https://github.com/sanctuarycomputer/candelabra.git

# build the changes
yarn build

# run developer instance against a website
node lib/index.js <entry-url> <options>

Feel free to make an issue if something isn't working properly or if you think there's a way to enhance the experience.