- TypeScript 97.6%
- CSS 1.7%
- JavaScript 0.4%
- HTML 0.2%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
|
|
||
| .github | ||
| .woodpecker | ||
| apps/web | ||
| patches | ||
| scripts | ||
| .dockerignore | ||
| .gitattributes | ||
| .gitignore | ||
| biome.json | ||
| bun.lock | ||
| bunfig.toml | ||
| CONTRIBUTING.md | ||
| Dockerfile | ||
| knip.jsonc | ||
| LICENSE | ||
| LOCALIZATION.md | ||
| nginx.conf | ||
| package.json | ||
| README.md | ||
| THIRD_PARTY_ASSETS.md | ||
TypeType Frontend
The React web client for TypeType.
You want to know the current position of TypeType about AI ? Go check this.
This repository contains the browser application and its nginx container. It owns the user interface, routing, settings, account flows, library views, and integration with the TypeType API and playback package.
If you want to install or update a complete TypeType instance, use the central TypeType repository and the self-hosting documentation.
Responsibilities
- Responsive desktop and mobile interface
- Search, channels, watch pages, playlists, subscriptions, and history
- Account, administration, import, and instance settings flows
- HTTP integration with TypeType-Server
- Playback UI around
@typetype/mse, Vidstack, DASH, and HLS providers - Theme, accessibility, and browser behavior
Playback engine internals belong in TypeType-Player. Extraction and user data belong in TypeType-Server.
Stack
| Area | Technology |
|---|---|
| UI | React 19 and TypeScript |
| Build | Vite 8 |
| Routing and server state | TanStack Router and TanStack Query |
| Local state | Zustand |
| Styling | Tailwind CSS 4 |
| Playback shell | Vidstack, @typetype/mse, dash.js, and hls.js |
| Tooling | Bun, Biome, Knip, and Sherif |
Development
Requirements:
- Bun 1.4.4
- A running TypeType-Server
bun install --frozen-lockfile
cp apps/web/.env.example apps/web/.env
bun run dev
The development server starts at http://localhost:5173 by default.
| Variable | Purpose |
|---|---|
VITE_API_URL |
API URL embedded in the frontend |
VITE_DEV_PROXY_TARGET |
API target used by the Vite development proxy |
Project structure
| Path | Contents |
|---|---|
apps/web/src/routes |
Application routes |
apps/web/src/components |
Shared interface and player components |
apps/web/src/hooks |
Query and behavior hooks |
apps/web/src/lib |
API clients, helpers, and integration code |
apps/web/src/settings |
Settings definitions and controls |
apps/web/src/stores |
Client-side state stores |
apps/web/tests |
Frontend tests |
Checks
bun run check
bun run test
bun run knip
bun run sherif
bun run build
Translation contributors can use Weblate
without editing code. The current catalog status can also be inspected locally
with bun run localization:report -- --markdown. See
LOCALIZATION.md for the source catalog, Weblate sync rules,
and the contributor workflow.
Read CONTRIBUTING.md before opening a pull request. Bug reports and feature requests belong in the central issue tracker.
License
TypeType Frontend is licensed under the MIT License. TypeType is not affiliated with, authorized by, or endorsed by YouTube, Google, NicoNico, BiliBili, or their affiliates.