{"id":24879,"library":"aberlaas","title":"Aberlaas","description":"Scaffold JavaScript projects with a zero-config setup for testing (Jest), linting (ESLint + Prettier), and release (semantic-release). Version 2.27.x, active development. Differentiator: opinionated all-in-one toolkit that enforces modern JS practices, including CI scripts and precommit hooks, reducing decision fatigue for new projects. Requires Node >=22.18.0.","status":"active","version":"2.27.4","language":"javascript","source_language":"en","source_url":"https://github.com/pixelastic/aberlaas","tags":["javascript","aberlaas","DX","lint","test","release","ci","precommit"],"install":[{"cmd":"npm install aberlaas","lang":"bash","label":"npm"},{"cmd":"yarn add aberlaas","lang":"bash","label":"yarn"},{"cmd":"pnpm add aberlaas","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"ESM-only since v2. No CommonJS export.","wrong":"const { init } = require('aberlaas')","symbol":"init","correct":"import { init } from 'aberlaas'"},{"note":"Named export, not default.","wrong":"import lint from 'aberlaas'","symbol":"lint","correct":"import { lint } from 'aberlaas'"},{"note":"Exported as 'test', not 'runTests'.","wrong":"import { runTests } from 'aberlaas'","symbol":"test","correct":"import { test } from 'aberlaas'"}],"quickstart":{"code":"import { init, lint, test, release } from 'aberlaas';\n\n// Initialize a new project\nawait init({ name: 'my-project', cwd: './my-project' });\n\n// Run lint\nawait lint({ fix: true });\n\n// Run tests\nawait test({ coverage: true });\n\n// Release\nawait release({ dryRun: true });\n\nconsole.log('Done!');","lang":"typescript","description":"Shows main exports: init, lint, test, release. Assumes Node >=22.18.0 with ESM."},"warnings":[{"fix":"Use import syntax and ensure package.json has \"type\": \"module\".","message":"v2 drops CommonJS support entirely. All imports must be ESM.","severity":"breaking","affected_versions":">=2.0.0"},{"fix":"Upgrade Node to >=22.18.0 or pin to earlier version.","message":"Minimum Node version raised to 22.18.0 in v2.27.4.","severity":"breaking","affected_versions":">=2.27.4"},{"fix":"Configure lint-staged in your project instead of using the 'precommit' flag.","message":"The 'precommit' option was removed in v2. Use 'lint-staged' instead.","severity":"deprecated","affected_versions":">=2.0.0"},{"fix":"Backup existing files before running init, or specify a fresh directory.","message":"Initialization overwrites files without confirmation: package.json, eslint config, jest config.","severity":"gotcha","affected_versions":"*"},{"fix":"Set GITHUB_TOKEN environment variable or run with 'dryRun: false' only in CI.","message":"The 'release' command uses semantic-release-preset and requires a proper CI environment (GitHub Actions). Local dry-run may fail if GITHUB_TOKEN is missing.","severity":"gotcha","affected_versions":"*"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run 'npm install aberlaas' or 'yarn add aberlaas'.","cause":"Package not installed or not in node_modules.","error":"Error [ERR_MODULE_NOT_FOUND]: Cannot find package 'aberlaas' imported from ..."},{"fix":"Add \"type\": \"module\" to package.json or rename file to .mjs.","cause":"Running ESM code in a CommonJS context without 'type': 'module'.","error":"SyntaxError: Unexpected token 'export'"},{"fix":"Use 'import { init } from 'aberlaas'' instead of 'import init from 'aberlaas''.","cause":"Using default import instead of named import.","error":"TypeError: init is not a function"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}