singularci

library1.1.13jsnpmunverified

SingularCI is a DSL transpiler for generating CI/CD configuration files from a unified YAML pipeline definition. Version 1.1.13 supports GitHub Actions and GitLab CI/CD, with planned support for Jenkins, TravisCI, CircleCI, and others. It is released as an npm package and standalone executables (via pkg), so it works with any project without requiring Node.js. Key differentiator: write pipelines once in a platform-agnostic DSL and transpile to multiple CI/CD formats. Release cadence is irregular; last update was 1.1.13.

devops

npm install singularci

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · SINGULARCI

singularci

devopsjavascriptv1.1.13

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

package

✓ import singularci from 'singularci'

✗ const singularci = require('singularci')

Package is a CLI tool; programmatic usage is not documented - main import is just for version info or initialization.

CLI

✓ npx singularci

✗ singularci

No programmatic API; use CLI via npx or binary.

DSL configuration

✓ // Add .singularci.yml to project root

The main usage is providing a .singularci.yml file in your project root, not importing code.

Shows how to define a pipeline in .singularci.yml and generate CI/CD files using the CLI.

# Add .singularci.yml to your project root with a simple pipeline: name: my-pipeline on: push: branches: [main] jobs: build: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 - run: npm install && npm test # Then run: npx singularci # This generates .github/workflows/my-pipeline.yml for GitHub Actions and .gitlab-ci.yml for GitLab CI/CD.

singularci --version

Debug

Known issues

breakingDSL syntax changed in v1.1.0: 'branches' keyword replaced by 'branches-ignore' and 'branches' now only specifies included branches.

fix

Update .singularci.yml to use new branch filtering syntax.

affects: <1.1.0

breakingOutput file paths changed in v1.1.0: GitHub Actions workflows are now generated under .github/workflows/ instead of a flat file.

fix

Adjust any CI references that expected the old output location.

affects: <1.1.0

deprecatedSupport for GitLab CI/CD is experimental in v1.1.13; the generated .gitlab-ci.yml may not cover all features.

fix

Review generated GitLab config manually and report issues.

affects: <=1.1.13

Errors

Common errors & fixes

Error: No .singularci.yml file found in /path/to/project

Missing configuration file in the project root.

fix

Create a .singularci.yml file with your pipeline definition.

Error: Invalid DSL: unknown keyword 'some_keyword'

Misuse of unupported DSL keyword.

fix

Refer to the DSL keywords documentation at https://github.com/Tobiaskr12/SingularCI/blob/main/documentation/dsl_keywords_documentation.yml

Error: Failed to parse YAML: mapping values are not allowed here

Malformed YAML in .singularci.yml.

fix

Validate YAML syntax with a linter; ensure proper indentation and key-value formatting.

singularci: command not found

Package not installed or not in PATH.

fix

Run 'npm install -g singularci' or use 'npx singularci'.

Upgrade

Version history

1.1.13latest on npm

Audit

Dependencies

pkgoptionalUsed to package SingularCI as standalone executables for non-Node.js environments

Agent activity

7 hits · last 30 days

node

Resources

githubhttps://github.com/Tobiaskr12/SingularCI ↗

packagehttps://www.npmjs.com/package/singularci ↗

homepagehttps://singularci.app ↗