Skip to content

docs(guide): 删掉 console.md 已整体过期的 Folder Structure 目录树 #3539

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
yinlianghui merged 1 commit into from
Aug 7, 2026
+4 −22
Merged

docs(guide): 删掉 console.md 已整体过期的 Folder Structure 目录树 #3539

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 4 additions & 22 deletions content/docs/guide/console.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -97,29 +97,11 @@ export default defineStack({
Leave it empty (`VITE_SERVER_URL=`) to use the same origin — the right setting when an ObjectStack server serves the console itself.
2. The console will use the ObjectStack client to discover metadata and perform CRUD operations against the server.

## Folder Structure
## Where the Code Lives

```
apps/console/
src/
App.tsx # Root component + routing
dataSource.ts # ObjectStackAdapter wrapper
components/
AppHeader.tsx # Top navbar (breadcrumbs, connection status)
AppSidebar.tsx # Left sidebar (app switcher, navigation tree)
CommandPalette.tsx # ⌘+K command bar
ConsoleLayout.tsx # AppShell wrapper
ObjectView.tsx # Object list view (wraps plugin-view)
RecordDetailView.tsx # Single-record detail view
pages/
CreateAppPage.tsx # App creation wizard page
EditAppPage.tsx # Edit existing app page
context/
ExpressionProvider.tsx # Expression evaluation context
hooks/
useBranding.ts # Delegates to @object-ui/layout
useObjectActions.ts # CRUD action handlers
```
Most of what you see in the console does not live in `apps/console`. The shell and layout, sidebar, header, command palette, object list and record detail views all ship from **`packages/app-shell`** (`@object-ui/app-shell`), so any host application can mount the same experience; the heavier view surfaces (grid, kanban, calendar, charts, designer) come from the `@object-ui/plugin-*` packages.

`apps/console` is the assembly layer on top: it owns the route tree, registers the plugin set, wires the backend connection, and adds the surfaces specific to this app (auth pages, the docs portal, system and settings pages). So when you want to change something you *see* in the console, look in `packages/app-shell` first.

## See Also

Expand Down