TOML to TypeScript converter
Convert TOML to TypeScript: interfaces from a sample TOML file such as Cargo.toml or pyproject.toml, with a named type for every table.
What you get
- TypeScript types from TOML: a TOML to TypeScript interface for every table, so config loaded with a TOML parser is fully typed.
- Checked by the TypeScript compiler: your TOML data type-checks against the result in strict mode.
- Turn a TOML config to TypeScript interfaces, so code that reads it is fully typed.
- Private and free: everything runs in your browser, nothing is uploaded, and there is no sign-up.
How each result is checked
- Step 1: Your TOML is parsed with a TOML 1.0 parser; errors show the line number.
- Step 1: The JSON is parsed back and compared with the parsed TOML, value by value.
- Step 2: The generated code is compiled with the real TypeScript compiler in strict mode.
- Step 2: Your JSON itself is type-checked against the root type. It must pass.
What can't convert exactly
- JSON has no date type, so TOML dates become ISO strings.
- Comments are not carried over.
- Types can only describe what the sample shows. A field that is null in every sample is typed as null; add a sample with a real value for a better type.
- Paste an array with several records to detect which fields are optional.
- Numbers are typed as number. Use the Zod converter if you need to check whole numbers at runtime.
Questions
How is a two-step conversion checked?
Your input is converted to JSON first, then to the target format. Each step has its own independent check, and both must pass. The checks of both steps are listed under every result.
Is my data uploaded?
No. Everything runs in your browser, in a background worker. Nothing is sent to a server.
How do I convert TOML to TypeScript online?
Paste your TOML or open a file on the left (or click Example). The TypeScript appears on the right as you type, already checked. Copy it, or download it as a file. Nothing is uploaded.
Can the TypeScript output be wrong?
Every result is checked before it is shown (the checks are listed on this page). If a check fails, the page says "Review needed" and why, instead of presenting the output as correct, and anything that cannot convert exactly is named in the notes.