# g2rain-admin-shell

(opens new window) (opens new window) (opens new window)

g2rain 官方 Vue 3 Main Shell 模板：Header / Sidebar / Tab / Workspace / Footer、Pinia Workspace 模型、@g2rain/platform/main + @g2rain/http + @g2rain/theme / @g2rain/ui 基线接入点，以及 qiankun RuntimeAdapter 扩展位。

本项目由 g2rain-app-cli (opens new window) 基于 g2rain-shell-template (opens new window) 生成。权威生产参考壳是 g2rain-main-shell (opens new window)；跨仓架构契约见中央 Main Shell 契约 (opens new window)，appkit 接线细节见其 Main Shell 接入 (opens new window)。

官网 (opens new window) · 完整文档 · 中央 Frontend Shell Profile (opens new window) · Issues (opens new window)

# 核心能力

能力	当前实现
Shell UI	Header、Sidebar、TabBar、Workspace、Footer；默认三个 Shell 本地页
Workspace / Tab	Pinia `workspace.store`：打开 / 激活 / 关闭；概览 Tab 不可关闭
Platform Main	`createMainPlatform` 在 `runtime/boot` 单例装配
HTTP	`@g2rain/http` 工厂挂在 `runtime/http`；Token / SSO 钩子预留
Theme / UI	`@g2rain/theme` + `@g2rain/platform/theme`；`G2rainUi` 插件
微前端	qiankun RuntimeAdapter 与实例队列；默认不注册业务 entry
部署	Vite `base` = Context Path；`nginx/default.conf.example` 示例

# 目录职责

目录	职责
`src/shared`	环境变量、项目名等无状态工具
`src/components`	不依赖 platform/runtime 的可复用 UI
`src/platform`	Workspace / Runtime / Session stores、Main/Theme、qiankun 适配
`src/runtime`	boot、路由、HTTP 装配
`src/shell`	布局、菜单、Shell 本地页
`src/views`	Shell 自有认证/租户页扩展位（模板基线为空）
`nginx`	静态托管与 Context Path 示例

# 占位符

占位符	用途	示例
`g2rain-admin-shell`	`package.json` name、`PROJECT_NAME`	`g2rain-admin-shell`
`admin`	Context Path（无前导 `/`）	`admin`
`3000`	Vite 开发端口	`3000`

.env 使用：

VITE_CONTEXT_PATH=/admin
VITE_SERVER_PORT=3000

模板仓本地验证前先替换为具体值（如 /admin 与 3000），再执行构建。

# 环境要求

Node.js >= 22
npm

# 快速开始

# 1) 将 .env 占位符替换为本地值（示例）
# VITE_CONTEXT_PATH=/admin
# VITE_SERVER_PORT=3000

npm install
npm run dev
npm run build

命令	说明
`npm run dev`	Vite 开发服务器
`npm run build`	`vue-tsc --noEmit` + `vite build`
`npm run preview`	预览构建产物

# 许可证与作者

# 作者

作者	联系
Jagger	g2rain_developer@163.com · g2rain.com (opens new window)
Alpha	g2rain.com (opens new window)

# 联系

官网：g2rain.com (opens new window)
Issues：GitHub Issues (opens new window)
讨论：GitHub Discussions (opens new window)
邮箱：g2rain_developer@163.com