Typethon is a Typescript pnpm monorepo with Turborepo containing a Python backend service and a Vite web application. Meant to provide a seamles developer experience for Typescript and Python devs. It's a minimal repository containing a Python backend, a Vite React app, and an autogenerated api-client that outputs a react-query client.
- Node.js 22+
- pnpm 10+
- Python 3.13+ (for Python services)
Install dependencies and set up the project:
# Install pnpm
npm i -g pnpm
pnpm install
# Install uv (https://docs.astral.sh/uv/)
brew install uv
# Setup local environment
pnpm setup-envStart all services in development mode:
pnpm dev| Command | Description |
|---|---|
pnpm setup-env |
Set up Python environments |
pnpm dev |
Run all services in development mode |
pnpm build |
Build all packages |
pnpm test |
Run tests across all packages |
pnpm typecheck |
Run type checking |
pnpm lint |
Lint all packages |
pnpm format |
Format code with Biome |
typethon/
├── apps/ # Application packages
│ ├── core/ # Core Python API service
│ └── web/ # Vite web application
├── packages/ # Shared packages (libraries, components, etc.)
│ └── api-client/ # Autogenerated TypeScript API client with React Query hooks
├── package.json # Root package configuration
├── pnpm-workspace.yaml # Workspace configuration
└── turbo.json # Turborepo configuration
The Core API service is a Python backend service using FastAPI with a layered architecture.
A modern Vite-powered web application that connects to the Core API.
An autogenerated TypeScript client that provides type-safe access to the Core API endpoints with built-in React Query hooks. This package automatically synchronizes with the Python backend's API definitions.
The Python environment is automatically set up through the setup-env script, which:
- Creates a
.venvvirtual environment in the core project - Installs all dependencies from requirements.txt
- Sets up Python tools and configuration
For the best Python development experience in VS Code or Cursor, install these extensions:
- Biome:
biomejs.biome- Official Biome extension for formatting and linting - Python:
ms-python.python- Main Python extension - Ruff:
charliermarsh.ruff- Code formatting and linting for Python - Mypy Type Checker:
ms-python.mypy-type-checker- Type checking
Once setup is complete, you'll need to select the Python interpreter:
- Open a python file
- Press
Cmd/Ctrl + Shift + P→Python: Select Interpreter - Choose the
.venv/bin/pythonin the core project folder
-
Create a new directory in the appropriate folder:
- For applications:
apps/<service-name> - For shared packages:
packages/<package-name>
- For applications:
-
Add the service to the workspace by updating its package.json
-
Add the service to the Turborepo pipeline in
turbo.jsonif needed