Name		Name	Last commit message	Last commit date
.github		.github
apps/web		apps/web
scripts		scripts
.dockerignore		.dockerignore
.gitignore		.gitignore
CONTRIBUTING.md		CONTRIBUTING.md
Dockerfile		Dockerfile
LICENSE		LICENSE
LOCALIZATION.md		LOCALIZATION.md
README.md		README.md
THIRD_PARTY_ASSETS.md		THIRD_PARTY_ASSETS.md
biome.json		biome.json
bun.lock		bun.lock
bunfig.toml		bunfig.toml
knip.jsonc		knip.jsonc
nginx.conf		nginx.conf
package.json		package.json

Repository files navigation

TypeType Frontend

The React web client for TypeType.

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.3.14
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.