2794835590fadba119ace2f45742ecd69dbfeeef
How Do You Convert? Repository
This repository hosts the HowDoYouConvert conversion catalog and the SvelteKit front end that renders every calculator page. The work is split between a generated data layer (calculators_list.md + migrate.py) and the hdyc-svelte app that consumes that data.
Key facts:
/calculators_list.mdis the canonical registry of published conversions. Each row in the active table becomes a calculator page in the UI.migrate.pyreads the registry and regenerateshdyc-svelte/src/lib/data/calculators.ts, so updates to calculations (or metadata like descriptions) must flow through the registry + generator.hdyc-svelterenders the homepage, category lists, and calculator routes (/[slug]) using the generated data, along with helpers insrc/lib/data/unitDefinitions.tsfor glossary blurbs.- The Node/Svelte front end lives entirely in
hdyc-svelte; usenpm run dev,npm run check, andnpm run buildfrom that directory for development and verification.
Typical workflow:
- Update
calculators_list.mdto add/adjust entries. - Run
python migrate.pyfrom the repository root to refreshhdyc-svelte/src/lib/data/calculators.ts. - Inside
hdyc-svelte, runnpm run check(and optionallynpm run devornpm run build) to ensure everything compiles before committing.
Description
Languages
TypeScript
85.6%
Svelte
6.8%
Python
3.7%
CSS
2.3%
JavaScript
1.2%
Other
0.4%