Skip to content

Latest commit

 

History

History
161 lines (138 loc) · 4.07 KB

README.md

File metadata and controls

161 lines (138 loc) · 4.07 KB

trailpack-hapi

Gitter NPM version Build status Dependency Status Code Climate

Hapi Trailpack. This pack binds the routes compiled in trailpack-router to a Hapi Server.

Usage

Load in your trailpack config.

// config/main.js
module.exports = {
  // ...
  packs: [
    require('trailpack-core'),
    require('trailpack-router'),
    require('trailpack-hapi')
  ]
}

View Config

Choose a template engine.

// config/views.js
module.exports = {
  engine: 'handlebars'
}

Then simply write your views in a directory called 'templates'! This feature has been tested with Jade and Handlebars.

Configuration

See config/web.js for an example.

port

The port to listen on. 3000 by default. Can also be set via the PORT environment variable.

Server configuration

Configure your Hapi.Server by adding options property to the web.js config in typical Hapi.server format. See: http://hapijs.com/api#new-serveroptions

// config/web.js
module.exports = {
  options: {

    routes: {
      cors: true
    }
  }
}

Hapi Plugins

Register your hapi plugins by adding them to the config/web.js config in typical Hapi plugin format. See: http://hapijs.com/tutorials/plugins#loading-a-plugin

// config/web.js
module.exports = {
  plugins: [
    {
      register: require('vision'),
      options: { }
    },
    {
      register: require('inert'),
      options: { }
    },
    {
      register: require('hapi-auth-hawk'),
      options: { }
    }
    // ...
  ],

  onPluginsLoaded: function (err) {
    // Note that `this` is Trails `app` instance
    this.packs.hapi.server.auth.strategy('default', 'hawk', { getCredentialsFunc: getCredentials });
  }
}

Hapi Views

// config/web.js
module.exports = {
  views: {
    engines: {
      html: require('some-view-engine')
    },
    path: 'views'
  }
}

Static Assets

// config/main.js
module.exports = {
  paths: {
    ...
    www: path.resolve(__dirname, '..', 'static')
    ...
  }
}

This allows static files such as js or images to be served in the /static directory. If you prefer, feel free to use a name other than 'static'!

Multiple Static Assets

// config/main.js
module.exports = {
  paths: {
    ...
    www: [
      {
        path: path.resolve(__dirname, '..', 'static'),
        humanUrl: '/admin'
      },
      {
        path: path.resolve(__dirname, '..', 'uploads', 'pictures', 'cats'),
        humanUrl: '/cats'
      }
    ]
    ...
  }
}

Also you can make multiple static assets with human url. For example your static files in /uploads/pictures/cats with humanUrl you url look like http://example.com/cats humanUrl - not require

Contributing

We love contributions! Please check out our Contributor's Guide for more information on how our projects are organized and how to get started.

License

MIT