Awesome Comparisons

Awesome Comparisons (formerly Ultimate Comparison Framework v2) is a powerful framework for creating feature-rich comparison websites with multi-dataset support, visual configuration editing, and shared criteria management.

Built with Angular. Read the original paper: The Ultimate Comparison Framework.

Quick Start

Requires Node 20+.

npm install
npm run dev -- --dataset aie-model
## or launch the business strategy dataset
npm run dev -- --dataset business-competition

Then open http://localhost:4200 (comparison) or http://localhost:4200/admin/config (config editor).

→ Full guide: Creating Your Comparison

Key Features

• Multi-dataset support - Host multiple comparisons in one repository → Learn more
• Visual config editor - Edit YAML at /admin/config with live preview → Learn more
• Shared configuration - Define criteria once, reuse across datasets → Learn more

Documentation

Start here: Documentation Index

Quick links:

• Overview - Architecture and concepts
• Update YOUR Comparison - Create/update datasets
• Migration from v2 - Upgrade guide
• Admin Config Interface - Visual editor guide
• Shared Configuration - Inheritance system
• Business Toolkit - Strategy frameworks + data authoring guide
• FAQ & Troubleshooting

Development

# Install dependencies
npm install

# Run dev server
npm run dev -- --dataset <dataset-id>

# Build for production (add --clean to wipe outputs first)
npm run build:prod
npm run build -- --dataset <dataset-id> --clean # optional clean build for a subset

# Release (stamps version)
npm run release

Admin interface: Navigate to /admin/config when the dev server is running. The config workspace backend runs on http://localhost:3100 and is auto-started by npm run dev/npm run start.

Deploy to GitHub Pages (full app)

This repository can be deployed as a static site for the public comparison UI. The admin config UI (/admin/config) is for local development and will not work on GitHub Pages.

• Workflow: .github/workflows/pages.yml
• Output deployed: dist/awesome-comparisons/browser
• URL: https://<org>.github.io/awesome-comparisons/
• Docs URL: https://<org>.github.io/awesome-comparisons/docs/

Setup steps (once):

1. In GitHub: Settings → Pages → Build and deployment → Source = GitHub Actions.
2. Ensure your default branch is main (or update the workflow trigger).

See docs/release-workflow.md for release process.

License

Code: MIT | Content: CC0-1.0