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.
- 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.
| 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 |
Requirements:
- Bun 1.3.14
- A running TypeType-Server
bun install --frozen-lockfile
cp apps/web/.env.example apps/web/.env
bun run devThe 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 |
| 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 |
bun run check
bun run test
bun run knip
bun run sherif
bun run buildRead CONTRIBUTING.md before opening a pull request. Bug reports and feature requests belong in the central issue tracker.
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.