django-typomatic
A simple solution for generating Typescript interfaces from your Django Rest Framework Serializers.
Decision gist · record as of 2026-08-14
Yes, with conditions. Install if you have a Django Rest Framework API and a TypeScript frontend, want to eliminate manual type synchronization, and are willing to verify the license status before production use. The low install friction and active repository make it reasonable, but the aging maintenance status means you should confirm it handles your serializer patterns before committing to it as a core build tool.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires django and djangorestframework to be installed; to use the CLI, django_typomatic must be added to INSTALLED_APPS.
- Low friction install with only django and djangorestframework as dependencies.
- Maintenance status is aging—last release was in 2024-07-02, though the repository remains active with a recent commit on 2025-04-27 and is not archived.
License · maintenance · safety
(unclear) — License status is unclear; no SPDX identifier or raw license text is available in the package metadata. Verify the actual license before adopting in proprietary or restricted-license projects.
last release 2024-07-02 (773 days) · last repo commit 2025-04-27 · 133 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 225,894 downloads/mo, #9,211 on PyPI
Alternatives
Verify before relying
pip install django-typomatic
from django_typomatic import ts_interface, generate_ts
@ts_interface()
class MySerializer:
name = None
generate_ts('./output.ts')- Python version compatibility not specified in metadata; verify support for your target Python version.
- Actual license terms unknown; check repository for LICENSE file or clarification before use in commercial projects.
- Whether the package handles all serializer field types your project uses.
What it is and what it does
django-typomatic is a code generator that reads Django Rest Framework serializers and outputs TypeScript interface definitions, eliminating manual type duplication between Python APIs and TypeScript frontends. It supports nested serializers, list fields, choice fields with optional enum generation, and field name camelization. The package offers two workflows: a decorator-based approach where you mark serializers with @ts_interface() and call generate_ts() to write files, or a CLI mode that scans your project for serializers without requiring decorators or manual function calls.
The tool bridges the impedance mismatch between Python's dynamic typing and TypeScript's static types by introspecting field definitions and mapping them to TypeScript equivalents. It handles patterns like many=True for arrays, nested object types, and choice constraints. Contexts allow you to partition serializers into separate output files, and the camelize option converts snake_case field names to camelCase for JavaScript conventions.
Use it for
- Generate TypeScript types automatically when your Django API serializers change, keeping frontend type definitions in sync without manual editing.
- Create separate TypeScript interface files for internal and external API versions using context-based filtering.
- Export choice fields as TypeScript enums to enforce type-safe selection of predefined values in the frontend.
- Reduce boilerplate by generating nested interface hierarchies that mirror your serializer structure.
- Integrate into a build pipeline to regenerate TypeScript definitions on each API deployment.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, with conditions.
Install if you have a Django Rest Framework API and a TypeScript frontend, want to eliminate manual type synchronization, and are willing to verify the license status before production use. The low install friction and active repository make it reasonable, but the aging maintenance status means you should confirm it handles your serializer patterns before committing to it as a core build tool.
Install
django-typomatic on PyPI
Before you install
Low friction install with only django and djangorestframework as dependencies. Maintenance status is aging—last release was in 2024-07-02, though the repository remains active with a recent commit on 2025-04-27 and is not archived.
Requires django and djangorestframework to be installed; to use the CLI, django_typomatic must be added to INSTALLED_APPS.
License in practice
License status is unclear; no SPDX identifier or raw license text is available in the package metadata. Verify the actual license before adopting in proprietary or restricted-license projects.
Quickstart
pip install django-typomatic
from django_typomatic import ts_interface, generate_ts
@ts_interface()
class MySerializer:
name = None
generate_ts('./output.ts')Verify before relying
- Python version compatibility not specified in metadata; verify support for your target Python version.
- Actual license terms unknown; check repository for LICENSE file or clarification before use in commercial projects.
- Whether the package handles all serializer field types your project uses.
Package facts
| License | Not declared unclear |
| Python support | Not specified |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 2 packagesdjangodjangorestframework |
| Maintenance | Aging 773 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 225,894 / month, #9,211 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
Evidence: django_typomatic-2.5.2-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “typescript interface generation django”
- django-typomaticGenerates TypeScript interfaces and enums from Django Rest Framework…
- pydantic-to-typescript2Converts Pydantic models to TypeScript interfaces via a CLI tool,…
- tree-sitter-typescriptProvides TypeScript and TSX language grammars for tree-sitter,…
Give your agent the search over MCP, or paste the wish link into any chat.
More Build Tools packages
Provides reusable utilities for Python packaging interoperability, including version handling, specifiers, markers, requirements, tags, and metadata parsing according to standards like PEP 440 and PEP 425.
Wraps any iterable to display a real-time progress bar in the terminal or Jupyter notebook, showing iteration count, elapsed time, and estimated time remaining.
pip is the standard installer for Python packages, enabling you to download and install packages from the Python Package Index and other indexes into your Python environment.
Hatchling is a standards-compliant Python build backend that handles packaging, metadata, and distribution of Python projects when configured in a project's pyproject.toml file.
Generates Python gRPC service stubs and message classes from Protocol Buffer definitions, enabling developers to build gRPC clients and servers.
pre-commit is a framework for installing and running git hooks written in any language before commits are made, automating code quality and validation checks across multi-language projects.
Install it if your team needs consistent, automated validation at commit time.
See also drf-jsonschema-serializer · drf-writable-nested · djangorestframework-dataclasses · drf-dynamic-fields · django-rest-polymorphic · djangorestframework · drf-excel · rest-framework-generic-relations · djangorestframework-recursive · djangorestframework-yaml