Neutrino HTML Loader Middleware

@neutrinojs/html-loader is Neutrino middleware for loading and importing HTML files from modules.

NPM version NPM downloads Join the Neutrino community on Spectrum


  • Node.js v6 LTS, v8, v9
  • Yarn v1.2.1+, or npm v5.4+
  • Neutrino v8


@neutrinojs/html-loader can be installed via the Yarn or npm clients.


❯ yarn add @neutrinojs/html-loader


npm install --save @neutrinojs/html-loader


@neutrinojs/html-loader can be consumed from the Neutrino API, middleware, or presets. Require this package and plug it into Neutrino:

// Using function middleware format
const html = require('@neutrinojs/html-loader');

// Use with default options

// Usage showing default options
neutrino.use(html, {
  name: '[name].[ext]'
// Using object or array middleware format

// Use with default options
module.exports = {
  use: ['@neutrinojs/html-loader']

// Usage showing default options
module.exports = {
  use: [
    ['@neutrinojs/html-loader', {
      name: '[name].[ext]'

The options object passed to this middleware will be passed as options to the html-loader used to load HTML files.


@neutrinojs/html-loader creates some conventions to make overriding the configuration easier once you are ready to make changes.


The following is a list of rules and their identifiers which can be overridden:

Name Description Environments and Commands
html Allows importing HTML files from modules. Contains a single loader named html. all


This middleware is part of the neutrino-dev repository, a monorepo containing all resources for developing Neutrino and its core presets and middleware. Follow the contributing guide for details.

results matching ""

    No results matching ""