Skip to content

sanctuarycomputer/candelabra

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

40 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

About

Shining a light on your website's accessibility

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published