Skip to content

Minimalistic boilerplate to quick-start API specification using API Blueprint description language.

License

Notifications You must be signed in to change notification settings

jsynowiec/api-blueprint-boilerplate

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

62 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Dev dependencies

Node.js version NPM version Ruby version Bundler version

MIT License Roadmap PRs Welcome Donate

Watch on GitHub Star on GitHub Tweet

api-blueprint-boilerplate

Minimalistic boilerplate to quick-start API specification using API Blueprint description language.

Provides a basic template for REST API documentation that contains some best practices for a pragmatic RESTful API and a set of tools to validate API Blueprint schema or export specification to HTML files.

Sample project is available in Apary: http://docs.apiblueprintboilerplate.apiary.io/

Quick start

This project requires Node.js 6.2+, NPM, Ruby and Bundler. So just make sure you have those installed. Then just type following commands:

git clone https://github.com/jsynowiec/api-blueprint-boilerplate
cd api-blueprint-boilerplate
npm install
bundle install
npm start

You now have a local preview server available at http://localhost:8080 that is validating and rendering your blueprint using Apiary CLI.

Testing against specification

To test the blueprint run npm test command. This will validate the schema using Drafter.js library.

Export HTML files

To compile the blueprint run npm run build. Files will be written to the build directory.

Publishing to Apiary

To publish your blueprint to Apiary.io you have to set two environment variables:

export APIARY_API_KEY="<token>"
export APIARY_API_NAME="<apiary project name>"

After that, you can run npm run publish command to upload your blueprint to Apiary project. You can also provide those two values before the command

APIARY_API_KEY="<token>" APIARY_API_NAME="<apiary project name>" npm run publish

Resources

License

MIT License. See the LICENSE file.

About

Minimalistic boilerplate to quick-start API specification using API Blueprint description language.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published