Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
This branch is 5 commits ahead, 791 commits behind ipfs:master.

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Dependency Status

Automated JavaScript project management.

Lead Maintainer

Victor Bjelkholm

Throughput Graph

Table of Contents


Scoped Github Token

Performing a release involves creating new commits and tags and then pushing them back to the repository you are releasing from. In order to do this you should create a GitHub personal access token and store it in the environmental variable AEGIR_GHTOKEN.

The only access scope it needs is public_repo.

Be aware that by storing it in ~/.profile or similar you will make it available to any program that runs on your computer.

Project Structure

The project structure when using this is quite strict, to ease replication and configuration overhead.

All source code should be placed under src, with the main entry point being src/index.js.

All test files should be placed under test. Individual test files should end in .spec.js and setup files for the node and the browser should be test/node.js and test/browser.js respectively.

Your package.json should have the following entries.

"main": "src/index.js",
"scripts": {
  "lint": "aegir lint",
  "release": "aegir release",
  "build": "aegir build",
  "test": "aegir test",
  "test:node": "aegir test --target node",
  "test:browser": "aegir test --target browser",
  "coverage": "aegir coverage",
  "coverage-publish": "aegir coverage --upload"

Stack Requirements

To bring you its many benefits, aegir requires



Linting uses eslint and standard with some custom rules to enforce some more strictness.

You can run it using

$ aegir lint


You can run it using

$ aegir test

There are also browser and node specific tasks

$ aegir test --target node
$ aegir test --target browser
$ aegir test --target webworker


Loading fixture files in node and the browser can be painful, that's why aegir provides a method to do this. For it to work you have to put your fixtures in the folder test/fixtures, and then

// test/awesome.spec.js
const loadFixture = require('aegir/fixtures')

const myFixture = loadFixture('test/fixtures/largefixture')

The path to the fixture is relative to the module root.

If you write a module like interface-ipfs-core which is to be consumed by other modules tests you need to pass in a third parameter such that the server is able to serve the correct files.

For example

// awesome-tests module
const loadFixture = require('aegir/fixtures')

const myFixture = loadFixture('test/fixtures/coolfixture', 'awesome-tests')
// tests for module using the awesome-tests
// .aegir.js file in the module using the awesome-tests module
'use strict'

module.exports = {
  karma: {
    files: [{
      pattern: 'node_modules/awesome-tests/test/fixtures/**/*',
      watched: false,
      served: true,
      included: false


You can run it using

$ aegir coverage

To auto publish coverage reports from Travis to Codecov add this to your .travis.yml file.

  - npm run coverage -- -upload


This will build a browser ready version into dist, so after publishing the results will be available under<module-name>/dist/index.js<module-name>/dist/index.min.js

You can run it using

$ aegir build

Specifying a custom entry file for Webpack

By default, aegir uses src/index.js as the entry file for Webpack. You can customize which file to use as the entry point by specifying entry field in your user configuration file. To do this, create .aegir.js file in your project's root diretory and add point the entry field to the file Webpack should use as the entry:

module.exports = {
  entry: "src/browser-index.js",

Webpack will use the specified file as the entry point and output it to dist/<filename>, eg. dist/browser-index.js.

If .aegir.js file is not present in the project, webpack will use src/index.js as the default entry file.

You can also make output filename different from entry filename with output field in .aegir.js:

module.exports = {
  output: "package",

It should be without any extensions because .js, .min.js and will be appended during the build.

Generating Webpack stats.json

Pass the --stats option to have Webpack generate a stats.json file for the bundle and save it in the project root (see e.g.

aegir build --stats


  1. Run linting
  2. Run tests
  3. Build everything
  4. Bump the version in package.json
  5. Generate a changelog based on the git log
  6. Commit the version change &
  7. Create a git tag
  8. Run git push to origin/master
  9. Publish a release to Github releases
  10. Generate documentation and push to github
  11. Publish to npm
# Major release
$ aegir release --type major
# Minor relase
$ aegir release --type minor
# Patch release
$ aegir release

This requires AEGIR_GHTOKEN to be set.

You can also specify the same targets as for test.

If no is present, one is generated the first time a release is done.

You can skip all changelog generation and the github release by passing in --no-changelog.

If you want no documentation generation you can pass --no-docs to the release task to disable documentation builds.


You can use aegir-docs to generate documentation. This uses documentation.js with the theme clean-documentation-theme.

To publish the documentation automatically to the gh-pages branch you can run

$ aegir docs --publish




AEgir - Automated JavaScript project building (temporary fork)







No packages published


  • JavaScript 98.3%
  • Shell 1.4%
  • Groovy 0.3%