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.
Requires Node 20+.
npm install
npm run dev -- --dataset aie-model
## or launch the business strategy dataset
npm run dev -- --dataset business-competitionThen open http://localhost:4200 (comparison) or http://localhost:4200/admin/config (config editor).
→ Full guide: Creating Your Comparison
- Multi-dataset support - Host multiple comparisons in one repository → Learn more
- Visual config editor - Edit YAML at
/admin/configwith live preview → Learn more - Shared configuration - Define criteria once, reuse across datasets → Learn more
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
# 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 releaseAdmin 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.
See docs/release-workflow.md for release process.