chatgptnextweb / nextchat

Code

How chatgptnextweb/nextchat is laid out, and where to start for common changes.

There is no import map for this report yet.

Where to start reading

Repository root
Repository root
Likely public API
Likely public API
Likely start-up file
Likely start-up file
Suggested starting pointAI
Suggested starting pointAI

Find files for a task

AI

Add Support for a New LLM Provider

Register the provider in the client controller's provider map
Add provider constants (model list, API endpoints) to app/constant.ts
Add localized provider name and settings labels to locale files

Add a New Pre-configured Mask/Prompt Template

Create mask entry in the appropriate locale file (e.g., app/masks/en.ts) with system prompt and model defaults
Run the mask build pipeline to compile templates for all locales
Optionally add localization for the mask name and description in other locale files
Verify the mask appears in the mask selection UI (loaded from app/store/mask.ts)

Add a New UI Settings Panel or Feature

Add new settings state to the config store
Add UI labels and help text to locale files
Integrate the new component into the main chat layout or settings modal

Enable Cloud Sync for a New Storage Backend

Add provider-specific configuration fields to the config store
Register the provider in the sync store's storage adapter selector
Add UI controls for connecting to the new backend in settings

Change the public API

Trace runtime behavior

Add or update tests

Change build or automation

RepoPilot lists up to 500 files, so a file missing here may still exist.

Files marked “likely” are guessed from their names.

Code quality and hotspots

Largest source files

Branch points42 per file on average
Code issues26 errors, 59 warnings
Largest file2,173 lines
Hotspot load0 high-risk files

Static checks on the 15 largest source files.

Tests, CI and tooling

CIGitHub Actions7 workflows
Tests36 test filesJest/Vitest · 0.23 test files per source file (file count, not coverage)
Dependency updatesDependabot

Test folders: test

Hotspots

app/components/chat.tsx1 commit in 180 days · 256 branch points
app/store/chat.ts1 commit in 180 days · 90 branch points
app/components/mcp-market.tsx1 commit in 180 days · 88 branch points
app/locales/da.ts1 commit in 180 days · 21 branch points
app/locales/en.ts1 commit in 180 days · 19 branch points
app/locales/ko.ts1 commit in 180 days · 18 branch points
app/locales/bn.ts1 commit in 180 days · 16 branch points
app/constant.ts1 commit in 180 days · 15 branch points

Files that change often and branch heavily, highest first. Branch points count if, loop, case, catch, ternary, && and || in the file.