Stack Advisor

Canonical definitions and the Stack Advisor web app for DevCentr: decision steps, options (with timeline and alternate context), recommendation rules, and browse/advice UI.

Report Bug · Request Feature

About The Project

This repository holds the source-of-truth advisor catalog and the Stack Advisor web UI consumed by DevCentr desktop and devcentr.org.

• Standalone app: https://dev-centr.github.io/stack-advisor/

• Site embed: https://devcentr.org/stack-advisor

back to top

Layout

catalog/advisor.sdl      # Source of truth (author here)
catalog/advisor.json     # Compiled artifact (web bundle; commit after compile)
lib/                     # Shared ranking/parser (@dev-centr/stack-advisor-core)
web/                     # Stack Advisor SPA (@dev-centr/stack-advisor)
scripts/compile-sdl.mjs  # SDL → JSON (Node; no DMD required)
docs/SDL-CONVENTIONS.adoc
CHANGELOG.adoc

Usage

Edit workflow

1. Change catalog/advisor.sdl.

2. Run node scripts/compile-sdl.mjs and commit both .sdl and .json.

3. Open a PR; CI validates compile + parse.

4. DevCentr desktop pulls via git (Settings → definitions repo URL).

5. devcentr.org bundles advisor.json at build when CI checks out this repo.

Consumers

| Client | How it loads | DevCentr desktop | git clone / git pull → reads catalog/advisor.sdl | Stack Advisor (standalone) | GitHub Pages builds web/ against catalog/advisor.json | devcentr.org | Build: checkout repo; aliases @dev-centr/stack-advisor + bundles catalog JSON

Default repo: https://github.com/dev-centr/stack-advisor.git

Local web app

cd web
npm install
npm run dev

back to top

Changelog

See CHANGELOG.adoc.

Related

• DevCentr spec: devcentr/docs/modules/specifications/pages/components/toolchain-advisor.adoc

Contact

DevCentr.org — support@devcentr.org

• Project: https://github.com/dev-centr/stack-advisor

• Site: https://devcentr.org

back to top