NOTICE: Since light is a work in progress, breaking changes will be made every MINOR patch until 2.0

getting started

a quick guide on how to start with light



  • Node >= 8.0.0
  • NPM >= 5.0.0


Install light

npm install light

and add the dev script to your package.json.

  // ...
  "scripts": {
    "start": "light start",
    "dev": "light dev"
  // ...


Once you've installed light, all .js files under the routes folder will be used to serve pages.

To get started, populate routes/index.js.

const light = require('light');

module.exports = light({
  path: '/',
  async handler() {
    return {
      hello: 'world',

Run npm run dev to start the development server. You should see an output in your terminal similar to the one below.

› start      🔥 igniting the server 🔥
› listening  on port 3000
› hmr        starting the hot reloader
› hmr        watching for changes

View your resulting website at localhost:3000!


That's it! You now have a dev server that

  • hot swaps to speed up development routes
  • supports many different serverless and hosting platforms
  • has very little magic behind the scenes, what you see in a route is what you get

Feel free to continue with the guides in the sidebar to understand more of the framework!