Repository navigation
Conversation
allozaur
force-pushed
the
allozaur/refactor/ui-folders
branch
from
November 12, 2026 00:09
b39a865 to
47e6a83
Compare
allozaur
force-pushed
the
allozaur/refactor/ui-folders
branch
2 times, most recently
from
November 12, 2026 01:27
ff3daab to
3226e0f
Compare
allozaur
changed the base branch from
allozaur/style/glass-surfaces
to
master
November 12, 2026 01:28
This was referenced Nov 12, 2026
Draft
allozaur
force-pushed
the
allozaur/refactor/ui-folders
branch
6 times, most recently
from
November 16, 2026 10:42
4904de8 to
83c3757
Compare
allozaur
force-pushed
the
allozaur/refactor/ui-folders
branch
from
November 16, 2026 11:28
83c3757 to
27f7029
Compare
allozaur
force-pushed
the
allozaur/refactor/ui-folders
branch
from
November 16, 2026 11:43
27f7029 to
ebe986f
Compare
allozaur
force-pushed
the
allozaur/refactor/ui-folders
branch
from
November 16, 2026 11:52
ebe986f to
5cd509d
Compare
The chat app moves to its own root folder, ui/apps/chat, as the first step of splitting the UI into one library (ui/lib) and the apps built on it (ui/apps). The code is unchanged; every path that pointed at tools/ui now points at ui/apps/chat: CMake adds it from tools/, and the Dockerfiles, the Nix package, the workflows, the labeler, CODEOWNERS, .editorconfig, the git hooks, the dev and demo scripts and the docs follow it. Assisted-by: Claude (Opus 5.5 Medium)
It was still called llama-ui, the name of the library that now sits beside it in ui/lib (@ggml-org/llama-ui). The package stays private; the app's display name and the llama-ui.zip build artifact are unchanged. Assisted-by: Claude (Opus 5.5 Medium)
The app in tools/ui is Llama Chat; Llama UI is the component library it is built from. Prose that said "Web UI", "web UI" or "WebUI" for the app now names it: the READMEs, SECURITY.md, the --ui help text, the CMake option description, one server log line, code comments and the Storybook intro. Names that others depend on are unchanged: the deprecated --webui flag aliases, the LLAMA_*_WEBUI CMake and environment names, the webui_settings field, the storage migration keys and the Nix attributes. Assisted-by: Claude (Opus 5.5 Medium)
…kill Changes under the old tools/ui path, as well as tools/server/webui, still get the Llama Chat checklist. Assisted-by: Claude (Opus 5.5 Medium)
Llama Chat no longer lives under tools/server/, so the exclusion listed under it now names ui/apps/chat. What is covered stays the same. Assisted-by: Claude (Opus 5.5 Medium)
allozaur
force-pushed
the
allozaur/refactor/ui-folders
branch
from
November 16, 2026 13:44
5cd509d to
1af9309
Compare
allozaur
force-pushed
the
allozaur/refactor/ui-folders
branch
from
November 16, 2026 13:47
1b270ed to
1af9309
Compare
llama-server refuses browser requests whose Origin does not match its own host unless --cors-origins allows it, and the Vite proxy forwarded the page's Origin (localhost:5173, or a LAN or Tailscale address). Loading a model, saving tools and /v1 calls failed with 403 under `vite dev`. The proxy now calls the server with its own Host and no Origin, WebSocket upgrades included. Sec-Fetch-Site still passes through, so requests from other sites stay refused. Assisted-by: Claude (Opus 5.5 Medium)
allozaur
force-pushed
the
allozaur/refactor/ui-folders
branch
from
November 16, 2026 13:52
1af9309 to
8285159
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Overview
The web UI moves from
tools/uitoui/apps/chat, the first app in a new rootui/folder, without changing any behavior, and it is called Llama Chat from now on: in the docs, the help text, the comments and its package name,@ggml-org/llama-chat. That leaves the Llama UI name to the design system that will live next to it.Additional information
Part 1 of 12 of a work-in-progress stack on the fork, based on
master. Every other layer of the stack sits on top of it. It has the commits ofggml-org/llama.cpp#32032plus one fork-only commit: the dev proxy calls llama-server without the page's Origin, sovite devpasses the server's cross-origin check from a LAN or Tailscale address. SvelteKit 3 comes next (#70), then Llama UI (ui/lib/ui) with the design system (#22).This is a mechanical change: files move, paths follow and prose names the app. No application code changes, and no flag, option or setting is renamed. Llama Chat builds, runs and ships exactly as before: a build of the app from this branch is identical to a build from master, apart from the build timestamp.
flowchart LR subgraph before["Before"] T["tools/ui<br/>the web UI"] end subgraph after["After: ui/"] subgraph apps["ui/apps: apps"] C["ui/apps/chat<br/>Llama Chat"] end end T -- "moved, code unchanged" --> COpen PRs that touch
tools/uineed a rebase, which git's rename detection handles for the moved files.Why: apps and packages
Until now the web UI was one folder that held both the design system and the chat app. The root
ui/folder draws a line between them:ui/appsholds apps, one folder each. An app owns its state and talks to llama-server. The first is Llama Chat, the web UI that llama-server serves, and this PR moves it there.ui/libwill hold packages, one folder each. A package is something other code installs. The first will be Llama UI (@ggml-org/llama-ui): design tokens, fonts, surfaces and components, with no business logic. It comes in a separate PR, together with Llama Chat moving onto it.flowchart TB S["llama-server<br/>serves the built-in web UI"] subgraph apps["ui/apps: apps own the business logic"] C["Llama Chat<br/>ui/apps/chat"] O["more apps and examples"]:::later end subgraph lib["ui/lib: packages, in a later PR"] L["Llama UI<br/>ui/lib/ui<br/>tokens, components, no business logic"]:::later end C -- "built and embedded, as today" --> S L -. "import, in a later PR" .-> C L -.-> O classDef later stroke-dasharray: 4 4 class lib laterSolid lines are what this PR contains. Dashed lines and boxes are later steps, shown only so the layout makes sense. That leaves room for more apps and packages on the same parts, and lets other projects, such as the llama.app website, install the library on its own.
What changed
tools/uiis nowui/apps/chat, with no code changes. In the move commit, 991 files are byte-for-byte renames and nine are edited; those nine are scripts and docs whose own paths changed (.env.example, the READMEs, the demo CLI and config,dev.shand the git hooks).tools/uipoints at the new path: CMake adds the app fromtools/CMakeLists.txt, with its build output inbuild/ui/apps/chat, and the Dockerfiles, the Nix package, the workflows, the labeler,CODEOWNERS,.editorconfigand the docs follow. Relative paths that reach outside the app are one level deeper.llama-ui, is now@ggml-org/llama-chat, so it no longer shares a name with the design system. It stays private; the app's display name and thellama-ui.zipbuild artifact are unchanged.README.mdandREADME-dev.md(including the "Web UI" and "Custom default Web UI preferences" headings), the rootREADME.mdscreenshot caption,SECURITY.md, the OpenVINO backend doc, the code-review skill, the--uiand--ui-mcp-proxyhelp text with their rows in the generated arguments table, theLLAMA_BUILD_UIoption description, the share-code log line, the Storybook intro and comments intools/server, the Nix package and the app. This replacesggml-org/llama.cpp#32118.tools/ui/andtools/server/webui/as former paths of Llama Chat.--webui*flag aliases, theLLAMA_BUILD_WEBUI,LLAMA_USE_PREBUILT_WEBUI,LLAMA_WEBUI_HF_BUCKETandHF_WEBUI_VERSIONnames, thewebui_settingsfield in/props, the storage migration keys and the Nix package'suseWebUiandwebuiattributes. The app's display name and PWA manifest name are a user-visible change for a separate PR.Testing
src,static,testsand.storybookofui/apps/chathave the same git tree hashes as intools/uion master, and so do the Vite, Svelte, TypeScript and shadcn configs.npm run buildfrom master'stools/uiand from this branch'sui/apps/chat, with the same dependencies, gives the same 70 files, checked again after rebasing onto master ata946eb541a. The CSS bundle is byte-identical, and the JS bundle,index.htmland the service worker differ only in the build timestamp and the hashes derived from it.ui/apps/chat:npm ci,npm run check,npm run lint, the unit tests andnpm run buildpass.llama-ui-assetstarget embeds the app'sdistfromui/apps/chat.Requirements
Claude (Opus 5.5 Medium)