Cobular

A minimal browser framework inspired by Angular where each component is a trio of files:

• HTML template
• scoped CSS
• COBOL logic compiled to WebAssembly

The runtime is JavaScript/TypeScript. Component logic can live in COBOL, in JS/TS sidecars, or both.

Docs

• docs/tutorial.md - single-page intro/tutorial
• docs/api.md - API reference (COBOL + JS)
• docs/ops-demo.md - deep dive on the ops dashboard demo
• docs/cobular-cli/readme.md - CLI overview

Quick start

Use the container scripts to avoid manual system dependency setup:

• Build the framework in a container: bash scripts/build_in_docker.sh
  • Podman: bash scripts/build_in_podman.sh
• Build + serve all demos + docs: bash scripts/run_demo_container_docker.sh
  • Podman: bash scripts/run_demo_container_podman.sh
• Generate static docs HTML: npm run docs:html

Demos

If you already have the toolchain installed locally:

• Ops dashboard: node scripts/utils/build_ops_demo.mjs then node scripts/utils/serve_ops_demo.mjs
• Other demos: node scripts/utils/serve_fetch_demo.mjs, node scripts/utils/serve_computed_demo.mjs, node scripts/utils/serve_jsbridge_demo.mjs

Publish

• Publish both packages: bash scripts/utils/publish_packages.sh

Docker demo container

Build and run all demos + docs without installing local deps:

bash scripts/run_demo_container_docker.sh

Podman users can run:

bash scripts/run_demo_container_podman.sh

This publishes the demo servers on localhost:

• Docs: http://127.0.0.1:5173
• Stress: http://127.0.0.1:5174
• Fetch: http://127.0.0.1:5175
• JS bridge: http://127.0.0.1:5176
• Computed: http://127.0.0.1:5177
• Ops: http://127.0.0.1:5178