Skip to content

Latest commit

 

History

History
83 lines (45 loc) · 2.68 KB

README.md

File metadata and controls

83 lines (45 loc) · 2.68 KB

The RabbitBird ES2015 Kit

The RabbitBird ES2015 Kit

Aiming to be the world's simplest setup for transpiling, linting and loading ES2015 in the browser!

NOTE: This projects demonstrates ES2015 usage in a browser environment. Using ES2015 in Node.js is a lot simpler and is well covered by the Babel documentation.

Requirements

Node.js is the only requirement for development. I recommend you use the latest version of Node and npm available.

Getting Started

Clone or download this repository to your computer.

Setup

Once downloaded, open a commandline window, navigate to the root directory.

To verify everything is working

Run in this order:

  • npm install
  • npm run lint
  • npm run transpile
  • npm run server

After running npm run server, open a web browser and navigate to http://localhost:8080/. Open the Developer Tools for your browser and you should see a message in the console.

Watcher for transpiling ES2015 files on save

An experimental and very simple watcher has been added. You can run it by executing npm run watcher.

Supported browsers

  • Chrome
  • Microsoft Edge
  • Internet Explorer 11
  • Firefox
  • Safari
  • Opera

Troubleshooting

If you're having trouble, please raise an issue on Github.

Why I created this project.

I teach classes on ES2015 and was frustrated with the size, complexity and scope of the other current boilerplate / starter kits.

I wanted something that would:

  • Teach someone why everything in the starter kit exists.
  • Enable every part of the project to be tinkered with, without being an expert in ES2015, Babel or ES2015 module loading.
  • Empower people to re-think the typical approach to building and tooling for Web projects.

Resources

Contributing

Contributions, questions and feedback are all welcome and will do my best to respond in a timely manner.

Bear in mind this is not a HTML5 boilerplate competitor or the like. It's just a simple project that shows the minimal amount of third party resources and code required to transpile, lint and load ES2015.

I would be particularly interested in contributions which make this project even simpler or leaner and which improve the documentation and ease of which all components can be understood.

License

Apache 2.0 Copyright 2016 RabbitBird