Atma Toolkit

0.15.24 verified Fri May 01 auth: no javascript maintenance

Atma Toolkit (v0.15.24) is a CLI build and task runner for JavaScript projects, especially those using IncludeJS. It provides actions for building HTML/JS/CSS assets, transpiling (e.g., ES6 to ES5, LESS to CSS), running shell commands, and serving HTTP. It loads configuration from JSON, YAML, or JS files. Unique: deeply integrates with IncludeJS module system, automatic script/style extraction from HTML, and support for multiple action groups. Release cadence: irregular, last release in 2017. Alternative to Gulp, Grunt, or Webpack but more opinionated and less maintained.

Common errors

error atma: command not found ↓

cause Package not installed globally.

fix

Run: npm install -g atma

error Cannot find module 'atma' ↓

cause Trying to require('atma') without installing locally.

fix

Install locally: npm install --save atma, then const atma = require('atma'); (though programmatic use may not work).

Warnings

deprecated Package is in maintenance mode; not actively developed since 2017. ↓

fix Consider migrating to modern build tools (Webpack, Vite, Parcel).

breaking The 'transpile' action may not work with modern Node.js (>=12) due to outdated dependencies. ↓

fix Use a dedicated transpiler like Babel or TypeScript compiler instead.

gotcha Global install required: 'npm install -g atma' – local install may not work for CLI. ↓

fix Install globally to use the 'atma' command.

gotcha Config files must be CommonJS modules; ES modules (.mjs) are not supported. ↓

fix Use module.exports = ... in .js files.

Install

npm install atma

yarn add atma

pnpm add atma

Imports

default
wrong
```
const atma = require('atma')
```
correct
```
import atma from 'atma'
```
Package is primarily a CLI tool, programmatic usage is not documented; may not export anything useful.

require('atma')

wrong

import atma from 'atma' (may fail)

correct

const atma = require('atma')

CJS only; ESM import may not work.

atma.run
```
const atma = require('atma'); atma.run(config)
```
Assuming programmatic API exists, but not officially supported.

Quickstart

Configure and run a build action that processes an HTML file with minification.

// Install globally
npm install -g atma

# Create a config file 'build.js'
module.exports = {
  action: 'build',
  file: 'index.html',
  minify: true,
  outputMain: 'dist/index.html',
  outputSources: 'dist/'
};

# Run build
atma build.js