Create independent server app for Vercel deployment - #1238

Merged
xuyushun441-sys merged 3 commits into
mainfrom
claude/independent-vercel-deployment
Apr 14, 2026
Merged

Create independent server app for Vercel deployment#1238
xuyushun441-sys merged 3 commits into
mainfrom
claude/independent-vercel-deployment

Conversation

@Claude

@ClaudeClaudeAI commented Apr 14, 2026

Copy link
Copy Markdown
Contributor

Separates backend API server from console frontend following the objectstack-ai/framework/apps/server pattern. Enables standalone Vercel deployment of ObjectStack server with Console UI served as static files.

Architecture

apps/server/
├── api/[[...route]].js # Vercel serverless entry point
├── server/index.ts # Kernel boot + Hono adapter
├── scripts/
│ ├── build-vercel.sh # Builds console + bundles API
│ └── bundle-api.mjs # ESBuild config (inlines all deps)
└── objectstack.config.ts # Plugin configuration

Implementation

Server Runtime:

  • Boots ObjectStack kernel with Hono adapter via @objectstack/hono
  • Initializes once on cold start, reuses for warm requests
  • Uses getRequestListener() for Vercel compatibility

Plugin Loading Order:

MemoryI18nPlugin// i18n service (before AppPlugin needs it)ObjectQLPlugin// Query engineDriverPlugin// InMemoryDriverAppPlugins// CRM, Todo, Kitchen SinkSetupPlugin// setupNav service (before AuthPlugin)AuthPlugin// AuthenticationConsolePlugin// Frontend SPA

Build Process:

  1. Console built with VITE_RUNTIME_MODE=server (connects to API, not MSW)
  2. server/index.ts bundled to api/_handler.js (all deps inlined)
  3. Console dist copied to public/ for static serving

Deployment:

  • /api/* → Serverless function (ObjectStack API)
  • /* → Static files (Console UI from CDN)
  • Environment: AUTH_SECRET (required, 32+ chars)

Files

  • package.json - ObjectStack dependencies + build scripts
  • vercel.json - Deployment config with build env vars
  • README.md / DEPLOYMENT.md - Usage and deployment guides
  • .env.example / .gitignore / .vercelignore
  • tsconfig.json - Node.js types, no rootDir constraint

Usage

cd apps/server
vercel env add AUTH_SECRET production
vercel --prod

Endpoints:

  • Console: https://your-app.vercel.app/
  • API: https://your-app.vercel.app/api/v1/discovery

ClaudeAIand others added 3 commits April 14, 2026 13:51
- Create apps/server package with all necessary files
- Add package.json with ObjectStack dependencies
- Create objectstack.config.ts with plugin configuration
- Add server/index.ts entrypoint with Hono adapter
- Create API handler (api/[[...route]].js) for Vercel
- Add build scripts (build-vercel.sh, bundle-api.mjs)
- Configure Vercel deployment (vercel.json)
- Add environment config (.env.example)
- Create .gitignore and .vercelignore
- Add tsconfig.json for TypeScript compilation
- Write comprehensive README.md
- Write detailed DEPLOYMENT.md guide
Agent-Logs-Url: https://github.com/objectstack-ai/objectui/sessions/1401bb2d-d094-4280-a66d-bee5388fc83a
Co-authored-by: xuyushun441-sys <255036401+xuyushun441-sys@users.noreply.github.com>
- Add @types/node to tsconfig types
- Remove rootDir to allow importing from parent dirs
- Fix datasources config format (add required config field)
- Add @ts-ignore for missing type exports in runtime packages
Agent-Logs-Url: https://github.com/objectstack-ai/objectui/sessions/1401bb2d-d094-4280-a66d-bee5388fc83a
Co-authored-by: xuyushun441-sys <255036401+xuyushun441-sys@users.noreply.github.com>
Add IMPLEMENTATION.md documenting the complete server app structure,
architecture, deployment process, and key decisions
Agent-Logs-Url: https://github.com/objectstack-ai/objectui/sessions/1401bb2d-d094-4280-a66d-bee5388fc83a
Co-authored-by: xuyushun441-sys <255036401+xuyushun441-sys@users.noreply.github.com>
@vercel

vercelBot commented Apr 14, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

ProjectDeploymentActionsUpdated (UTC)
objectui-demoReadyReadyPreview, CommentApr 14, 2026 2:04pm
1 Skipped Deployment
ProjectDeploymentActionsUpdated (UTC)
objectuiIgnoredIgnoredApr 14, 2026 2:04pm

Request Review

@xuyushun441-sys
xuyushun441-sys marked this pull request as ready for review April 14, 2026 14:04
@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

MetricValueBudget
Main entry (gzip)287.4 KB350 KB
Entry fileindex-KDzKK6UM.js
StatusPASS

📦 Bundle Size Report

PackageSizeGzipped
app-shell (index.js)0.43KB0.22KB
app-shell (types.js)0.01KB0.04KB
auth (AuthContext.js)0.31KB0.24KB
auth (AuthGuard.js)1.17KB0.53KB
auth (AuthProvider.js)7.37KB1.79KB
auth (ForgotPasswordForm.js)4.91KB1.66KB
auth (LoginForm.js)5.00KB1.64KB
auth (PreviewBanner.js)0.90KB0.50KB
auth (RegisterForm.js)6.85KB1.86KB
auth (UserMenu.js)3.40KB1.22KB
auth (createAuthClient.js)5.14KB1.60KB
auth (createAuthenticatedFetch.js)1.24KB0.60KB
auth (index.js)1.18KB0.51KB
auth (types.js)0.59KB0.35KB
auth (useAuth.js)1.57KB0.57KB
collaboration (CommentThread.js)18.38KB4.49KB
collaboration (LiveCursors.js)3.17KB1.27KB
collaboration (PresenceAvatars.js)3.65KB1.42KB
collaboration (index.js)1.16KB0.50KB
collaboration (useCommentSearch.js)1.98KB0.88KB
collaboration (useConflictResolution.js)7.75KB1.86KB
collaboration (useMentionNotifications.js)1.81KB0.68KB
collaboration (usePresence.js)6.33KB1.84KB
collaboration (useRealtimeSubscription.js)7.91KB2.01KB
components (index.js)1979.64KB464.57KB
core (index.js)1.29KB0.51KB
create-plugin (index.js)10.13KB3.17KB
data-objectstack (index.js)46.96KB11.67KB
fields (LookupField-B6MOSQVJ.js)30.75KB8.34KB
fields (index.js)74.79KB15.84KB
fields (rolldown-runtime-CAFD8bLK.js)0.24KB0.24KB
fields (useFieldTranslation-Bv3oUVgb.js)0.26KB0.21KB
i18n (i18n.js)2.03KB0.77KB
i18n (index.js)1.99KB0.79KB
i18n (provider.js)4.63KB1.47KB
i18n (useObjectLabel.js)4.51KB1.61KB
i18n (useSafeTranslation.js)1.63KB0.57KB
layout (index.js)88.09KB24.91KB
mobile (MobileProvider.js)0.92KB0.49KB
mobile (ResponsiveContainer.js)0.94KB0.38KB
mobile (breakpoints.js)1.51KB0.70KB
mobile (index.js)1.19KB0.53KB
mobile (pwa.js)0.97KB0.49KB
mobile (serviceWorker.js)1.48KB0.62KB
mobile (useBreakpoint.js)1.54KB0.65KB
mobile (useGesture.js)4.42KB1.27KB
mobile (usePullToRefresh.js)2.53KB0.85KB
mobile (useResponsive.js)0.71KB0.42KB
mobile (useResponsiveConfig.js)1.36KB0.63KB
mobile (useSpecGesture.js)1.77KB0.77KB
mobile (useTouchTarget.js)1.01KB0.54KB
permissions (PermissionContext.js)0.31KB0.25KB
permissions (PermissionGuard.js)0.89KB0.45KB
permissions (PermissionProvider.js)3.11KB0.87KB
permissions (evaluator.js)4.00KB1.23KB
permissions (index.js)0.85KB0.40KB
permissions (store.js)0.91KB0.42KB
permissions (useFieldPermissions.js)1.28KB0.52KB
permissions (usePermissions.js)0.99KB0.49KB
plugin-aggrid (AddressField-DKqaE9pD.js)2.85KB0.81KB
plugin-aggrid (AgGridImpl-DBqxIsko.js)6.39KB2.24KB
plugin-aggrid (AutoNumberField-0RU2dNKe.js)0.43KB0.34KB
plugin-aggrid (AvatarField-C5b9biGa.js)2.65KB1.15KB
plugin-aggrid (BooleanField-DRzAZhSq.js)1.23KB0.58KB
plugin-aggrid (CodeField-RWhnDMyL.js)0.86KB0.53KB
plugin-aggrid (ColorField-B-YAFXdz.js)1.26KB0.59KB
plugin-aggrid (CurrencyField-Bu80a-sI.js)1.52KB0.80KB
plugin-aggrid (DateField-CV-NpLbM.js)0.65KB0.43KB
plugin-aggrid (DateTimeField--YTsgTjw.js)0.82KB0.48KB
plugin-aggrid (EmailField-B-3fWJsH.js)0.88KB0.53KB
plugin-aggrid (FileField-BcGMvBnI.js)5.67KB2.05KB
plugin-aggrid (FormulaField-MQXJZOep.js)0.64KB0.46KB
plugin-aggrid (GeolocationField-D3BrmwqV.js)4.10KB1.49KB
plugin-aggrid (GridField-DHsGo9l2.js)1.96KB0.76KB
plugin-aggrid (ImageField-BBqwJEkk.js)2.65KB1.12KB
plugin-aggrid (LocationField-DSvhU9Dz.js)1.00KB0.59KB
plugin-aggrid (LookupField-DoOmbbZF.js)33.78KB8.95KB
plugin-aggrid (LookupField-KfYQlgUd.js)0.08KB0.11KB
plugin-aggrid (MasterDetailField-BnSPGAtS.js)3.40KB1.14KB
plugin-aggrid (NumberField-Kz4_o5DE.js)0.76KB0.50KB
plugin-aggrid (ObjectAgGridImpl-DrI0aa8t.js)726.52KB183.35KB
plugin-aggrid (ObjectField-C1qkl6s4.js)1.63KB0.82KB
plugin-aggrid (PasswordField-k5JeKk9f.js)1.88KB0.94KB
plugin-aggrid (PercentField-Dmipqv0I.js)1.85KB0.88KB
plugin-aggrid (PhoneField-Dn4h6V9H.js)0.87KB0.54KB
plugin-aggrid (QRCodeField-BIrSW1Zr.js)3.27KB1.25KB
plugin-aggrid (RatingField-5iMhn2GL.js)2.05KB0.93KB
plugin-aggrid (RichTextField-CN5BRd_7.js)1.19KB0.63KB
plugin-aggrid (SelectField-Bjk_S2zT.js)1.07KB0.58KB
plugin-aggrid (SelectField-CcWvzp9g.js)0.08KB0.11KB
plugin-aggrid (SignatureField-BAMvNrE6.js)3.14KB1.29KB
plugin-aggrid (SliderField-C9IhmjbF.js)1.11KB0.55KB
plugin-aggrid (SummaryField-R9RENAZv.js)0.60KB0.45KB
plugin-aggrid (TextAreaField-BY63Nr6-.js)1.12KB0.64KB
plugin-aggrid (TextField-SIw8aMzf.js)0.90KB0.50KB
plugin-aggrid (TimeField-xxziHPjE.js)0.61KB0.40KB
plugin-aggrid (UrlField-Ihk3_ff5.js)1.04KB0.57KB
plugin-aggrid (UserField-BHl6mmIH.js)2.62KB0.98KB
plugin-aggrid (VectorField-Ci167cxr.js)0.92KB0.52KB
plugin-aggrid (createLucideIcon-BjfZYZey.js)1.72KB0.93KB
plugin-aggrid (image-DlUdeTgT.js)0.36KB0.26KB
plugin-aggrid (index.js)10.33KB2.43KB
plugin-aggrid (jsx-runtime-CGDkM_Jn.js)7.83KB2.89KB
plugin-aggrid (plus-BwEV_Q5_.js)0.19KB0.19KB
plugin-aggrid (upload-DPiohvXv.js)0.29KB0.23KB
plugin-aggrid (useFieldTranslation-C69OtouR.js)9.53KB3.69KB
plugin-aggrid (x-BFq2GeQ5.js)0.19KB0.19KB
plugin-ai (index.js)24.21KB6.44KB
plugin-calendar (index.js)44.95KB12.96KB
plugin-charts (AdvancedChartImpl-JDjuxIZW.js)118.19KB24.21KB
plugin-charts (BarChart-Bvt5Se8Q.js)523.60KB126.89KB
plugin-charts (ChartImpl-CQj8Kris.js)3.62KB1.16KB
plugin-charts (index.js)12.70KB4.07KB
plugin-charts (jsx-runtime-C8d0IhUE.js)8.40KB3.09KB
plugin-chatbot (index.js)1194.20KB340.76KB
plugin-dashboard (index.js)158.02KB38.69KB
plugin-designer (index.js)244.91KB47.93KB
plugin-detail (AddressField-CDLSeyNx.js)2.66KB0.79KB
plugin-detail (AutoNumberField-CtE7suf5.js)0.44KB0.34KB
plugin-detail (AvatarField-Xuieq0ZI.js)2.40KB1.09KB
plugin-detail (BooleanField-DwfMKknK.js)1.14KB0.55KB
plugin-detail (CodeField-CfwgRxx2.js)0.80KB0.50KB
plugin-detail (ColorField-YKHA7dBD.js)1.19KB0.57KB
plugin-detail (CurrencyField-tvS3fPAF.js)1.47KB0.78KB
plugin-detail (DateField-BKqXpkOh.js)0.60KB0.41KB
plugin-detail (DateTimeField-CR-nJCE7.js)0.78KB0.46KB
plugin-detail (EmailField-CgvW1Qal.js)0.83KB0.51KB
plugin-detail (FileField-BVAme2ML.js)5.12KB1.90KB
plugin-detail (FormulaField-DamJ2VaG.js)0.66KB0.45KB
plugin-detail (GeolocationField-C99z7ZBM.js)3.31KB1.23KB
plugin-detail (GridField-C9JbpTx_.js)1.83KB0.74KB
plugin-detail (ImageField-CDANtgVV.js)2.45KB1.09KB
plugin-detail (LocationField-ZSyZ0O-h.js)0.97KB0.58KB
plugin-detail (LookupField-B3hQJt95.js)30.30KB8.21KB
plugin-detail (LookupField-D00z6gn_.js)0.08KB0.11KB
plugin-detail (MasterDetailField-B0HTmmD7.js)2.90KB1.00KB
plugin-detail (NumberField-DL2QAL7X.js)0.72KB0.47KB
plugin-detail (ObjectField-JYvUnuRO.js)1.57KB0.79KB
plugin-detail (PasswordField-DVTimsc3.js)1.13KB0.66KB
plugin-detail (PercentField-DjR6BSpw.js)1.76KB0.86KB
plugin-detail (PhoneField-CX1JL-jp.js)0.82KB0.51KB
plugin-detail (QRCodeField-CH_1pU6R.js)2.15KB0.93KB
plugin-detail (RatingField-rRi_P0N0.js)1.56KB0.69KB
plugin-detail (RichTextField-CJqLWlrb.js)1.12KB0.62KB
plugin-detail (SelectField-DGoDoRM_.js)0.96KB0.55KB
plugin-detail (SelectField-XBVI50AD.js)0.08KB0.11KB
plugin-detail (SignatureField-2CnhcWI0.js)2.81KB1.15KB
plugin-detail (SliderField-DEpMVXko.js)1.04KB0.53KB
plugin-detail (SummaryField-7ch9aqAu.js)0.62KB0.45KB
plugin-detail (TextAreaField-Cmw1oXcw.js)1.06KB0.62KB
plugin-detail (TextField-OTLa3p51.js)0.84KB0.47KB
plugin-detail (TimeField-DKPoNWoR.js)0.57KB0.38KB
plugin-detail (UrlField-CxbmzP9f.js)0.98KB0.55KB
plugin-detail (UserField-ChvwUkMK.js)2.43KB0.95KB
plugin-detail (VectorField-BVClL8Vw.js)0.92KB0.52KB
plugin-detail (index.js)136.92KB30.17KB
plugin-detail (src-C56Ly5uG.js)1959.48KB461.51KB
plugin-detail (useFieldTranslation-CkxqyB82.js)0.25KB0.20KB
plugin-editor (MonacoImpl-BMgw4JKF.js)17.97KB5.53KB
plugin-editor (index.js)1.61KB0.74KB
plugin-editor (jsx-runtime-HjdTyiyb.js)7.63KB2.80KB
plugin-form (index.js)60.57KB13.62KB
plugin-gantt (index.js)215.46KB52.74KB
plugin-grid (index.js)101.88KB27.60KB
plugin-kanban (KanbanEnhanced-TdUe0kQH.js)30.21KB8.94KB
plugin-kanban (KanbanImpl-BtlPa7GE.js)13.33KB4.08KB
plugin-kanban (chevron-down-B6UH8BbF.js)0.15KB0.18KB
plugin-kanban (index.js)18.55KB5.80KB
plugin-kanban (plus-BTqoaaEC.js)9.31KB3.57KB
plugin-kanban (sortable.esm-LJG1TjKd.js)59.36KB17.43KB
plugin-list (index.js)2029.65KB476.72KB
plugin-map (chunk-vKJrgz-R.js)1.18KB0.67KB
plugin-map (index.js)123.69KB30.35KB
plugin-map (maplibre-gl-DK6BxsIK.js)1331.05KB296.40KB
plugin-markdown (MarkdownImpl-BcKLng98.js)220.68KB53.61KB
plugin-markdown (index.js)1.04KB0.58KB
plugin-markdown (jsx-runtime-B1W8iDPg.js)8.39KB3.09KB
plugin-report (index.js)70.37KB13.98KB
plugin-timeline (index.js)99.93KB24.18KB
plugin-view (index.js)116.61KB31.05KB
plugin-workflow (index.js)81.18KB17.06KB
providers (DataSourceProvider.js)0.75KB0.39KB
providers (MetadataProvider.js)1.37KB0.59KB
providers (ThemeProvider.js)1.55KB0.67KB
providers (index.js)0.29KB0.17KB
providers (types.js)0.01KB0.04KB
react (LazyPluginLoader.js)3.77KB1.33KB
react (SchemaRenderer.js)9.07KB2.83KB
react (index.js)0.76KB0.42KB
tenant (TenantContext.js)0.31KB0.25KB
tenant (TenantGuard.js)1.04KB0.43KB
tenant (TenantProvider.js)2.76KB0.98KB
tenant (TenantScopedQuery.js)0.77KB0.44KB
tenant (index.js)0.75KB0.38KB
tenant (resolver.js)2.64KB0.76KB
tenant (useTenant.js)0.50KB0.32KB
tenant (useTenantBranding.js)0.62KB0.39KB
types (ai.js)0.20KB0.17KB
types (api-types.js)0.20KB0.18KB
types (app.js)2.87KB0.99KB
types (base.js)0.20KB0.18KB
types (blocks.js)0.20KB0.18KB
types (complex.js)0.20KB0.18KB
types (crud.js)0.20KB0.18KB
types (data-display.js)0.20KB0.18KB
types (data-protocol.js)0.20KB0.19KB
types (data.js)0.20KB0.18KB
types (designer.js)0.74KB0.39KB
types (disclosure.js)0.20KB0.18KB
types (feedback.js)0.20KB0.18KB
types (field-types.js)0.20KB0.18KB
types (form.js)0.20KB0.18KB
types (index.js)1.25KB0.58KB
types (layout.js)0.20KB0.18KB
types (mobile.js)0.20KB0.18KB
types (navigation.js)0.20KB0.18KB
types (objectql.js)0.20KB0.18KB
types (overlay.js)0.20KB0.18KB
types (permissions.js)0.20KB0.18KB
types (plugin-scope.js)0.20KB0.18KB
types (record-components.js)0.20KB0.19KB
types (registry.js)0.20KB0.18KB
types (reports.js)0.20KB0.18KB
types (tenant.js)0.20KB0.18KB
types (theme.js)0.20KB0.18KB
types (ui-action.js)0.20KB0.18KB
types (views.js)0.20KB0.18KB
types (widget.js)0.20KB0.18KB
types (workflow.js)0.20KB0.18KB

Size Limits

  • ✅ Core packages should be < 50KB gzipped
  • ✅ Component packages should be < 100KB gzipped
  • ⚠️ Plugin packages should be < 150KB gzipped

@xuyushun441-sys
xuyushun441-sys merged commit 86fed66 into mainApr 14, 2026
9 of 10 checks passed
os-support-ai pushed a commit that referenced this pull request Aug 25, 2026
`AI_QUOTA_CODES` / `AiQuotaCode` held only the three lowercase legacy literals
while cloud PR #1238 landed the SCREAMING_SNAKE ledger vocabulary, so
`asAiQuotaCode`'s exact `Set.has` missed every converged producer and a
quota-exhausted user fell through to the generic "Response failed" banner
instead of the upgrade / top-up CTA.
- Add `AI_ALLOWANCE_EXHAUSTED`, `AI_DESIGN_QUOTA_EXHAUSTED` and
`AI_DATA_CHAT_TRIAL_EXHAUSTED`, KEEPING the lowercase trio for
transition-period producers.
- Read the companion fields from the declared envelope's `error.details`
(the position cloud PR #1238 shipped) with the legacy top-level read as the
fallback limb, matching the total order the code lookup already uses.
- Add `resetsTonight`, set only when a producer sends an actual boolean.
- Widen the dialect matrix from three to four and pin that the per-turn cap's
generic `QUOTA_EXCEEDED` keeps its rate-limit path.
No existing assertion in `tool-display.test.ts` was weakened or removed.
akarma-synetal pushed a commit to akarma-synetal/objectui that referenced this pull request Sep 1, 2026
…ck-ai#6383)
`AI_QUOTA_CODES` / `AiQuotaCode` held only the three lowercase legacy literals
while cloud PR objectstack-ai#1238 landed the SCREAMING_SNAKE ledger vocabulary, so
`asAiQuotaCode`'s exact `Set.has` missed every converged producer and a
quota-exhausted user fell through to the generic "Response failed" banner
instead of the upgrade / top-up CTA.
- Add `AI_ALLOWANCE_EXHAUSTED`, `AI_DESIGN_QUOTA_EXHAUSTED` and
`AI_DATA_CHAT_TRIAL_EXHAUSTED`, KEEPING the lowercase trio for
transition-period producers.
- Read the companion fields from the declared envelope's `error.details`
(the position cloud PR objectstack-ai#1238 shipped) with the legacy top-level read as the
fallback limb, matching the total order the code lookup already uses.
- Add `resetsTonight`, set only when a producer sends an actual boolean.
- Widen the dialect matrix from three to four and pin that the per-turn cap's
generic `QUOTA_EXCEEDED` keeps its rate-limit path.
No existing assertion in `tool-display.test.ts` was weakened or removed.
Co-authored-by: Claude <noreply@anthropic.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@Claude@xuyushun441-sys
, 'i'); if (__m === '*' || __re.test(location.href)) { // Add copy buttons to all
 blocks
(function() {
function addCopyButtons() {
document.querySelectorAll('pre code').forEach(function(codeBlock) {
if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;
codeBlock.parentElement.setAttribute('data-copy-added', 'true');
var btn = document.createElement('button');
btn.textContent = 'Copy';
btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';
btn.onmouseover = function() { this.style.opacity = '1'; };
btn.onmouseout = function() { this.style.opacity = '0.7'; };
btn.onclick = function() {
navigator.clipboard.writeText(codeBlock.textContent).then(function() {
btn.textContent = 'Copied!';
setTimeout(function() { btn.textContent = 'Copy'; }, 1500);
});
};
codeBlock.parentElement.style.position = 'relative';
codeBlock.parentElement.appendChild(btn);
});
}
addCopyButtons();
// Re-run on dynamic content
var observer = new MutationObserver(addCopyButtons);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
Skip to content

Create independent server app for Vercel deployment - #1238

Merged
xuyushun441-sys merged 3 commits into
mainfrom
claude/independent-vercel-deployment
Apr 14, 2026
Merged

Create independent server app for Vercel deployment#1238
xuyushun441-sys merged 3 commits into
mainfrom
claude/independent-vercel-deployment

Conversation

@Claude

@ClaudeClaudeAI commented Apr 14, 2026

Copy link
Copy Markdown
Contributor

Separates backend API server from console frontend following the objectstack-ai/framework/apps/server pattern. Enables standalone Vercel deployment of ObjectStack server with Console UI served as static files.

Architecture

apps/server/
├── api/[[...route]].js # Vercel serverless entry point
├── server/index.ts # Kernel boot + Hono adapter
├── scripts/
│ ├── build-vercel.sh # Builds console + bundles API
│ └── bundle-api.mjs # ESBuild config (inlines all deps)
└── objectstack.config.ts # Plugin configuration

Implementation

Server Runtime:

  • Boots ObjectStack kernel with Hono adapter via @objectstack/hono
  • Initializes once on cold start, reuses for warm requests
  • Uses getRequestListener() for Vercel compatibility

Plugin Loading Order:

MemoryI18nPlugin// i18n service (before AppPlugin needs it)ObjectQLPlugin// Query engineDriverPlugin// InMemoryDriverAppPlugins// CRM, Todo, Kitchen SinkSetupPlugin// setupNav service (before AuthPlugin)AuthPlugin// AuthenticationConsolePlugin// Frontend SPA

Build Process:

  1. Console built with VITE_RUNTIME_MODE=server (connects to API, not MSW)
  2. server/index.ts bundled to api/_handler.js (all deps inlined)
  3. Console dist copied to public/ for static serving

Deployment:

  • /api/* → Serverless function (ObjectStack API)
  • /* → Static files (Console UI from CDN)
  • Environment: AUTH_SECRET (required, 32+ chars)

Files

  • package.json - ObjectStack dependencies + build scripts
  • vercel.json - Deployment config with build env vars
  • README.md / DEPLOYMENT.md - Usage and deployment guides
  • .env.example / .gitignore / .vercelignore
  • tsconfig.json - Node.js types, no rootDir constraint

Usage

cd apps/server
vercel env add AUTH_SECRET production
vercel --prod

Endpoints:

  • Console: https://your-app.vercel.app/
  • API: https://your-app.vercel.app/api/v1/discovery

ClaudeAIand others added 3 commits April 14, 2026 13:51
- Create apps/server package with all necessary files
- Add package.json with ObjectStack dependencies
- Create objectstack.config.ts with plugin configuration
- Add server/index.ts entrypoint with Hono adapter
- Create API handler (api/[[...route]].js) for Vercel
- Add build scripts (build-vercel.sh, bundle-api.mjs)
- Configure Vercel deployment (vercel.json)
- Add environment config (.env.example)
- Create .gitignore and .vercelignore
- Add tsconfig.json for TypeScript compilation
- Write comprehensive README.md
- Write detailed DEPLOYMENT.md guide
Agent-Logs-Url: https://github.com/objectstack-ai/objectui/sessions/1401bb2d-d094-4280-a66d-bee5388fc83a
Co-authored-by: xuyushun441-sys <255036401+xuyushun441-sys@users.noreply.github.com>
- Add @types/node to tsconfig types
- Remove rootDir to allow importing from parent dirs
- Fix datasources config format (add required config field)
- Add @ts-ignore for missing type exports in runtime packages
Agent-Logs-Url: https://github.com/objectstack-ai/objectui/sessions/1401bb2d-d094-4280-a66d-bee5388fc83a
Co-authored-by: xuyushun441-sys <255036401+xuyushun441-sys@users.noreply.github.com>
Add IMPLEMENTATION.md documenting the complete server app structure,
architecture, deployment process, and key decisions
Agent-Logs-Url: https://github.com/objectstack-ai/objectui/sessions/1401bb2d-d094-4280-a66d-bee5388fc83a
Co-authored-by: xuyushun441-sys <255036401+xuyushun441-sys@users.noreply.github.com>
@vercel

vercelBot commented Apr 14, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

ProjectDeploymentActionsUpdated (UTC)
objectui-demoReadyReadyPreview, CommentApr 14, 2026 2:04pm
1 Skipped Deployment
ProjectDeploymentActionsUpdated (UTC)
objectuiIgnoredIgnoredApr 14, 2026 2:04pm

Request Review

@xuyushun441-sys
xuyushun441-sys marked this pull request as ready for review April 14, 2026 14:04
@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

MetricValueBudget
Main entry (gzip)287.4 KB350 KB
Entry fileindex-KDzKK6UM.js
StatusPASS

📦 Bundle Size Report

PackageSizeGzipped
app-shell (index.js)0.43KB0.22KB
app-shell (types.js)0.01KB0.04KB
auth (AuthContext.js)0.31KB0.24KB
auth (AuthGuard.js)1.17KB0.53KB
auth (AuthProvider.js)7.37KB1.79KB
auth (ForgotPasswordForm.js)4.91KB1.66KB
auth (LoginForm.js)5.00KB1.64KB
auth (PreviewBanner.js)0.90KB0.50KB
auth (RegisterForm.js)6.85KB1.86KB
auth (UserMenu.js)3.40KB1.22KB
auth (createAuthClient.js)5.14KB1.60KB
auth (createAuthenticatedFetch.js)1.24KB0.60KB
auth (index.js)1.18KB0.51KB
auth (types.js)0.59KB0.35KB
auth (useAuth.js)1.57KB0.57KB
collaboration (CommentThread.js)18.38KB4.49KB
collaboration (LiveCursors.js)3.17KB1.27KB
collaboration (PresenceAvatars.js)3.65KB1.42KB
collaboration (index.js)1.16KB0.50KB
collaboration (useCommentSearch.js)1.98KB0.88KB
collaboration (useConflictResolution.js)7.75KB1.86KB
collaboration (useMentionNotifications.js)1.81KB0.68KB
collaboration (usePresence.js)6.33KB1.84KB
collaboration (useRealtimeSubscription.js)7.91KB2.01KB
components (index.js)1979.64KB464.57KB
core (index.js)1.29KB0.51KB
create-plugin (index.js)10.13KB3.17KB
data-objectstack (index.js)46.96KB11.67KB
fields (LookupField-B6MOSQVJ.js)30.75KB8.34KB
fields (index.js)74.79KB15.84KB
fields (rolldown-runtime-CAFD8bLK.js)0.24KB0.24KB
fields (useFieldTranslation-Bv3oUVgb.js)0.26KB0.21KB
i18n (i18n.js)2.03KB0.77KB
i18n (index.js)1.99KB0.79KB
i18n (provider.js)4.63KB1.47KB
i18n (useObjectLabel.js)4.51KB1.61KB
i18n (useSafeTranslation.js)1.63KB0.57KB
layout (index.js)88.09KB24.91KB
mobile (MobileProvider.js)0.92KB0.49KB
mobile (ResponsiveContainer.js)0.94KB0.38KB
mobile (breakpoints.js)1.51KB0.70KB
mobile (index.js)1.19KB0.53KB
mobile (pwa.js)0.97KB0.49KB
mobile (serviceWorker.js)1.48KB0.62KB
mobile (useBreakpoint.js)1.54KB0.65KB
mobile (useGesture.js)4.42KB1.27KB
mobile (usePullToRefresh.js)2.53KB0.85KB
mobile (useResponsive.js)0.71KB0.42KB
mobile (useResponsiveConfig.js)1.36KB0.63KB
mobile (useSpecGesture.js)1.77KB0.77KB
mobile (useTouchTarget.js)1.01KB0.54KB
permissions (PermissionContext.js)0.31KB0.25KB
permissions (PermissionGuard.js)0.89KB0.45KB
permissions (PermissionProvider.js)3.11KB0.87KB
permissions (evaluator.js)4.00KB1.23KB
permissions (index.js)0.85KB0.40KB
permissions (store.js)0.91KB0.42KB
permissions (useFieldPermissions.js)1.28KB0.52KB
permissions (usePermissions.js)0.99KB0.49KB
plugin-aggrid (AddressField-DKqaE9pD.js)2.85KB0.81KB
plugin-aggrid (AgGridImpl-DBqxIsko.js)6.39KB2.24KB
plugin-aggrid (AutoNumberField-0RU2dNKe.js)0.43KB0.34KB
plugin-aggrid (AvatarField-C5b9biGa.js)2.65KB1.15KB
plugin-aggrid (BooleanField-DRzAZhSq.js)1.23KB0.58KB
plugin-aggrid (CodeField-RWhnDMyL.js)0.86KB0.53KB
plugin-aggrid (ColorField-B-YAFXdz.js)1.26KB0.59KB
plugin-aggrid (CurrencyField-Bu80a-sI.js)1.52KB0.80KB
plugin-aggrid (DateField-CV-NpLbM.js)0.65KB0.43KB
plugin-aggrid (DateTimeField--YTsgTjw.js)0.82KB0.48KB
plugin-aggrid (EmailField-B-3fWJsH.js)0.88KB0.53KB
plugin-aggrid (FileField-BcGMvBnI.js)5.67KB2.05KB
plugin-aggrid (FormulaField-MQXJZOep.js)0.64KB0.46KB
plugin-aggrid (GeolocationField-D3BrmwqV.js)4.10KB1.49KB
plugin-aggrid (GridField-DHsGo9l2.js)1.96KB0.76KB
plugin-aggrid (ImageField-BBqwJEkk.js)2.65KB1.12KB
plugin-aggrid (LocationField-DSvhU9Dz.js)1.00KB0.59KB
plugin-aggrid (LookupField-DoOmbbZF.js)33.78KB8.95KB
plugin-aggrid (LookupField-KfYQlgUd.js)0.08KB0.11KB
plugin-aggrid (MasterDetailField-BnSPGAtS.js)3.40KB1.14KB
plugin-aggrid (NumberField-Kz4_o5DE.js)0.76KB0.50KB
plugin-aggrid (ObjectAgGridImpl-DrI0aa8t.js)726.52KB183.35KB
plugin-aggrid (ObjectField-C1qkl6s4.js)1.63KB0.82KB
plugin-aggrid (PasswordField-k5JeKk9f.js)1.88KB0.94KB
plugin-aggrid (PercentField-Dmipqv0I.js)1.85KB0.88KB
plugin-aggrid (PhoneField-Dn4h6V9H.js)0.87KB0.54KB
plugin-aggrid (QRCodeField-BIrSW1Zr.js)3.27KB1.25KB
plugin-aggrid (RatingField-5iMhn2GL.js)2.05KB0.93KB
plugin-aggrid (RichTextField-CN5BRd_7.js)1.19KB0.63KB
plugin-aggrid (SelectField-Bjk_S2zT.js)1.07KB0.58KB
plugin-aggrid (SelectField-CcWvzp9g.js)0.08KB0.11KB
plugin-aggrid (SignatureField-BAMvNrE6.js)3.14KB1.29KB
plugin-aggrid (SliderField-C9IhmjbF.js)1.11KB0.55KB
plugin-aggrid (SummaryField-R9RENAZv.js)0.60KB0.45KB
plugin-aggrid (TextAreaField-BY63Nr6-.js)1.12KB0.64KB
plugin-aggrid (TextField-SIw8aMzf.js)0.90KB0.50KB
plugin-aggrid (TimeField-xxziHPjE.js)0.61KB0.40KB
plugin-aggrid (UrlField-Ihk3_ff5.js)1.04KB0.57KB
plugin-aggrid (UserField-BHl6mmIH.js)2.62KB0.98KB
plugin-aggrid (VectorField-Ci167cxr.js)0.92KB0.52KB
plugin-aggrid (createLucideIcon-BjfZYZey.js)1.72KB0.93KB
plugin-aggrid (image-DlUdeTgT.js)0.36KB0.26KB
plugin-aggrid (index.js)10.33KB2.43KB
plugin-aggrid (jsx-runtime-CGDkM_Jn.js)7.83KB2.89KB
plugin-aggrid (plus-BwEV_Q5_.js)0.19KB0.19KB
plugin-aggrid (upload-DPiohvXv.js)0.29KB0.23KB
plugin-aggrid (useFieldTranslation-C69OtouR.js)9.53KB3.69KB
plugin-aggrid (x-BFq2GeQ5.js)0.19KB0.19KB
plugin-ai (index.js)24.21KB6.44KB
plugin-calendar (index.js)44.95KB12.96KB
plugin-charts (AdvancedChartImpl-JDjuxIZW.js)118.19KB24.21KB
plugin-charts (BarChart-Bvt5Se8Q.js)523.60KB126.89KB
plugin-charts (ChartImpl-CQj8Kris.js)3.62KB1.16KB
plugin-charts (index.js)12.70KB4.07KB
plugin-charts (jsx-runtime-C8d0IhUE.js)8.40KB3.09KB
plugin-chatbot (index.js)1194.20KB340.76KB
plugin-dashboard (index.js)158.02KB38.69KB
plugin-designer (index.js)244.91KB47.93KB
plugin-detail (AddressField-CDLSeyNx.js)2.66KB0.79KB
plugin-detail (AutoNumberField-CtE7suf5.js)0.44KB0.34KB
plugin-detail (AvatarField-Xuieq0ZI.js)2.40KB1.09KB
plugin-detail (BooleanField-DwfMKknK.js)1.14KB0.55KB
plugin-detail (CodeField-CfwgRxx2.js)0.80KB0.50KB
plugin-detail (ColorField-YKHA7dBD.js)1.19KB0.57KB
plugin-detail (CurrencyField-tvS3fPAF.js)1.47KB0.78KB
plugin-detail (DateField-BKqXpkOh.js)0.60KB0.41KB
plugin-detail (DateTimeField-CR-nJCE7.js)0.78KB0.46KB
plugin-detail (EmailField-CgvW1Qal.js)0.83KB0.51KB
plugin-detail (FileField-BVAme2ML.js)5.12KB1.90KB
plugin-detail (FormulaField-DamJ2VaG.js)0.66KB0.45KB
plugin-detail (GeolocationField-C99z7ZBM.js)3.31KB1.23KB
plugin-detail (GridField-C9JbpTx_.js)1.83KB0.74KB
plugin-detail (ImageField-CDANtgVV.js)2.45KB1.09KB
plugin-detail (LocationField-ZSyZ0O-h.js)0.97KB0.58KB
plugin-detail (LookupField-B3hQJt95.js)30.30KB8.21KB
plugin-detail (LookupField-D00z6gn_.js)0.08KB0.11KB
plugin-detail (MasterDetailField-B0HTmmD7.js)2.90KB1.00KB
plugin-detail (NumberField-DL2QAL7X.js)0.72KB0.47KB
plugin-detail (ObjectField-JYvUnuRO.js)1.57KB0.79KB
plugin-detail (PasswordField-DVTimsc3.js)1.13KB0.66KB
plugin-detail (PercentField-DjR6BSpw.js)1.76KB0.86KB
plugin-detail (PhoneField-CX1JL-jp.js)0.82KB0.51KB
plugin-detail (QRCodeField-CH_1pU6R.js)2.15KB0.93KB
plugin-detail (RatingField-rRi_P0N0.js)1.56KB0.69KB
plugin-detail (RichTextField-CJqLWlrb.js)1.12KB0.62KB
plugin-detail (SelectField-DGoDoRM_.js)0.96KB0.55KB
plugin-detail (SelectField-XBVI50AD.js)0.08KB0.11KB
plugin-detail (SignatureField-2CnhcWI0.js)2.81KB1.15KB
plugin-detail (SliderField-DEpMVXko.js)1.04KB0.53KB
plugin-detail (SummaryField-7ch9aqAu.js)0.62KB0.45KB
plugin-detail (TextAreaField-Cmw1oXcw.js)1.06KB0.62KB
plugin-detail (TextField-OTLa3p51.js)0.84KB0.47KB
plugin-detail (TimeField-DKPoNWoR.js)0.57KB0.38KB
plugin-detail (UrlField-CxbmzP9f.js)0.98KB0.55KB
plugin-detail (UserField-ChvwUkMK.js)2.43KB0.95KB
plugin-detail (VectorField-BVClL8Vw.js)0.92KB0.52KB
plugin-detail (index.js)136.92KB30.17KB
plugin-detail (src-C56Ly5uG.js)1959.48KB461.51KB
plugin-detail (useFieldTranslation-CkxqyB82.js)0.25KB0.20KB
plugin-editor (MonacoImpl-BMgw4JKF.js)17.97KB5.53KB
plugin-editor (index.js)1.61KB0.74KB
plugin-editor (jsx-runtime-HjdTyiyb.js)7.63KB2.80KB
plugin-form (index.js)60.57KB13.62KB
plugin-gantt (index.js)215.46KB52.74KB
plugin-grid (index.js)101.88KB27.60KB
plugin-kanban (KanbanEnhanced-TdUe0kQH.js)30.21KB8.94KB
plugin-kanban (KanbanImpl-BtlPa7GE.js)13.33KB4.08KB
plugin-kanban (chevron-down-B6UH8BbF.js)0.15KB0.18KB
plugin-kanban (index.js)18.55KB5.80KB
plugin-kanban (plus-BTqoaaEC.js)9.31KB3.57KB
plugin-kanban (sortable.esm-LJG1TjKd.js)59.36KB17.43KB
plugin-list (index.js)2029.65KB476.72KB
plugin-map (chunk-vKJrgz-R.js)1.18KB0.67KB
plugin-map (index.js)123.69KB30.35KB
plugin-map (maplibre-gl-DK6BxsIK.js)1331.05KB296.40KB
plugin-markdown (MarkdownImpl-BcKLng98.js)220.68KB53.61KB
plugin-markdown (index.js)1.04KB0.58KB
plugin-markdown (jsx-runtime-B1W8iDPg.js)8.39KB3.09KB
plugin-report (index.js)70.37KB13.98KB
plugin-timeline (index.js)99.93KB24.18KB
plugin-view (index.js)116.61KB31.05KB
plugin-workflow (index.js)81.18KB17.06KB
providers (DataSourceProvider.js)0.75KB0.39KB
providers (MetadataProvider.js)1.37KB0.59KB
providers (ThemeProvider.js)1.55KB0.67KB
providers (index.js)0.29KB0.17KB
providers (types.js)0.01KB0.04KB
react (LazyPluginLoader.js)3.77KB1.33KB
react (SchemaRenderer.js)9.07KB2.83KB
react (index.js)0.76KB0.42KB
tenant (TenantContext.js)0.31KB0.25KB
tenant (TenantGuard.js)1.04KB0.43KB
tenant (TenantProvider.js)2.76KB0.98KB
tenant (TenantScopedQuery.js)0.77KB0.44KB
tenant (index.js)0.75KB0.38KB
tenant (resolver.js)2.64KB0.76KB
tenant (useTenant.js)0.50KB0.32KB
tenant (useTenantBranding.js)0.62KB0.39KB
types (ai.js)0.20KB0.17KB
types (api-types.js)0.20KB0.18KB
types (app.js)2.87KB0.99KB
types (base.js)0.20KB0.18KB
types (blocks.js)0.20KB0.18KB
types (complex.js)0.20KB0.18KB
types (crud.js)0.20KB0.18KB
types (data-display.js)0.20KB0.18KB
types (data-protocol.js)0.20KB0.19KB
types (data.js)0.20KB0.18KB
types (designer.js)0.74KB0.39KB
types (disclosure.js)0.20KB0.18KB
types (feedback.js)0.20KB0.18KB
types (field-types.js)0.20KB0.18KB
types (form.js)0.20KB0.18KB
types (index.js)1.25KB0.58KB
types (layout.js)0.20KB0.18KB
types (mobile.js)0.20KB0.18KB
types (navigation.js)0.20KB0.18KB
types (objectql.js)0.20KB0.18KB
types (overlay.js)0.20KB0.18KB
types (permissions.js)0.20KB0.18KB
types (plugin-scope.js)0.20KB0.18KB
types (record-components.js)0.20KB0.19KB
types (registry.js)0.20KB0.18KB
types (reports.js)0.20KB0.18KB
types (tenant.js)0.20KB0.18KB
types (theme.js)0.20KB0.18KB
types (ui-action.js)0.20KB0.18KB
types (views.js)0.20KB0.18KB
types (widget.js)0.20KB0.18KB
types (workflow.js)0.20KB0.18KB

Size Limits

  • ✅ Core packages should be < 50KB gzipped
  • ✅ Component packages should be < 100KB gzipped
  • ⚠️ Plugin packages should be < 150KB gzipped

@xuyushun441-sys
xuyushun441-sys merged commit 86fed66 into mainApr 14, 2026
9 of 10 checks passed
os-support-ai pushed a commit that referenced this pull request Aug 25, 2026
`AI_QUOTA_CODES` / `AiQuotaCode` held only the three lowercase legacy literals
while cloud PR #1238 landed the SCREAMING_SNAKE ledger vocabulary, so
`asAiQuotaCode`'s exact `Set.has` missed every converged producer and a
quota-exhausted user fell through to the generic "Response failed" banner
instead of the upgrade / top-up CTA.
- Add `AI_ALLOWANCE_EXHAUSTED`, `AI_DESIGN_QUOTA_EXHAUSTED` and
`AI_DATA_CHAT_TRIAL_EXHAUSTED`, KEEPING the lowercase trio for
transition-period producers.
- Read the companion fields from the declared envelope's `error.details`
(the position cloud PR #1238 shipped) with the legacy top-level read as the
fallback limb, matching the total order the code lookup already uses.
- Add `resetsTonight`, set only when a producer sends an actual boolean.
- Widen the dialect matrix from three to four and pin that the per-turn cap's
generic `QUOTA_EXCEEDED` keeps its rate-limit path.
No existing assertion in `tool-display.test.ts` was weakened or removed.
akarma-synetal pushed a commit to akarma-synetal/objectui that referenced this pull request Sep 1, 2026
…ck-ai#6383)
`AI_QUOTA_CODES` / `AiQuotaCode` held only the three lowercase legacy literals
while cloud PR objectstack-ai#1238 landed the SCREAMING_SNAKE ledger vocabulary, so
`asAiQuotaCode`'s exact `Set.has` missed every converged producer and a
quota-exhausted user fell through to the generic "Response failed" banner
instead of the upgrade / top-up CTA.
- Add `AI_ALLOWANCE_EXHAUSTED`, `AI_DESIGN_QUOTA_EXHAUSTED` and
`AI_DATA_CHAT_TRIAL_EXHAUSTED`, KEEPING the lowercase trio for
transition-period producers.
- Read the companion fields from the declared envelope's `error.details`
(the position cloud PR objectstack-ai#1238 shipped) with the legacy top-level read as the
fallback limb, matching the total order the code lookup already uses.
- Add `resetsTonight`, set only when a producer sends an actual boolean.
- Widen the dialect matrix from three to four and pin that the per-turn cap's
generic `QUOTA_EXCEEDED` keeps its rate-limit path.
No existing assertion in `tool-display.test.ts` was weakened or removed.
Co-authored-by: Claude <noreply@anthropic.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@Claude@xuyushun441-sys
, 'i'); if (__m === '*' || __re.test(location.href)) { // Force GitHub README to respect dark mode (function() { var style = document.createElement('style'); style.textContent = ' .markdown-body { color-scheme: dark light; } .markdown-body pre { background: #161b22 !important; } .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; } .markdown-body table th, .markdown-body table td { border-color: #30363d !important; } .markdown-body img { background: #0d1117; } .markdown-body blockquote { border-left-color: #8b949e; } .markdown-body hr { border-color: #30363d; } '; document.head.appendChild(style); })(); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Create independent server app for Vercel deployment - #1238

Merged
xuyushun441-sys merged 3 commits into
mainfrom
claude/independent-vercel-deployment
Apr 14, 2026
Merged

Create independent server app for Vercel deployment#1238
xuyushun441-sys merged 3 commits into
mainfrom
claude/independent-vercel-deployment

Conversation

@Claude

@ClaudeClaudeAI commented Apr 14, 2026

Copy link
Copy Markdown
Contributor

Separates backend API server from console frontend following the objectstack-ai/framework/apps/server pattern. Enables standalone Vercel deployment of ObjectStack server with Console UI served as static files.

Architecture

apps/server/
├── api/[[...route]].js # Vercel serverless entry point
├── server/index.ts # Kernel boot + Hono adapter
├── scripts/
│ ├── build-vercel.sh # Builds console + bundles API
│ └── bundle-api.mjs # ESBuild config (inlines all deps)
└── objectstack.config.ts # Plugin configuration

Implementation

Server Runtime:

  • Boots ObjectStack kernel with Hono adapter via @objectstack/hono
  • Initializes once on cold start, reuses for warm requests
  • Uses getRequestListener() for Vercel compatibility

Plugin Loading Order:

MemoryI18nPlugin// i18n service (before AppPlugin needs it)ObjectQLPlugin// Query engineDriverPlugin// InMemoryDriverAppPlugins// CRM, Todo, Kitchen SinkSetupPlugin// setupNav service (before AuthPlugin)AuthPlugin// AuthenticationConsolePlugin// Frontend SPA

Build Process:

  1. Console built with VITE_RUNTIME_MODE=server (connects to API, not MSW)
  2. server/index.ts bundled to api/_handler.js (all deps inlined)
  3. Console dist copied to public/ for static serving

Deployment:

  • /api/* → Serverless function (ObjectStack API)
  • /* → Static files (Console UI from CDN)
  • Environment: AUTH_SECRET (required, 32+ chars)

Files

  • package.json - ObjectStack dependencies + build scripts
  • vercel.json - Deployment config with build env vars
  • README.md / DEPLOYMENT.md - Usage and deployment guides
  • .env.example / .gitignore / .vercelignore
  • tsconfig.json - Node.js types, no rootDir constraint

Usage

cd apps/server
vercel env add AUTH_SECRET production
vercel --prod

Endpoints:

  • Console: https://your-app.vercel.app/
  • API: https://your-app.vercel.app/api/v1/discovery

ClaudeAIand others added 3 commits April 14, 2026 13:51
- Create apps/server package with all necessary files
- Add package.json with ObjectStack dependencies
- Create objectstack.config.ts with plugin configuration
- Add server/index.ts entrypoint with Hono adapter
- Create API handler (api/[[...route]].js) for Vercel
- Add build scripts (build-vercel.sh, bundle-api.mjs)
- Configure Vercel deployment (vercel.json)
- Add environment config (.env.example)
- Create .gitignore and .vercelignore
- Add tsconfig.json for TypeScript compilation
- Write comprehensive README.md
- Write detailed DEPLOYMENT.md guide
Agent-Logs-Url: https://github.com/objectstack-ai/objectui/sessions/1401bb2d-d094-4280-a66d-bee5388fc83a
Co-authored-by: xuyushun441-sys <255036401+xuyushun441-sys@users.noreply.github.com>
- Add @types/node to tsconfig types
- Remove rootDir to allow importing from parent dirs
- Fix datasources config format (add required config field)
- Add @ts-ignore for missing type exports in runtime packages
Agent-Logs-Url: https://github.com/objectstack-ai/objectui/sessions/1401bb2d-d094-4280-a66d-bee5388fc83a
Co-authored-by: xuyushun441-sys <255036401+xuyushun441-sys@users.noreply.github.com>
Add IMPLEMENTATION.md documenting the complete server app structure,
architecture, deployment process, and key decisions
Agent-Logs-Url: https://github.com/objectstack-ai/objectui/sessions/1401bb2d-d094-4280-a66d-bee5388fc83a
Co-authored-by: xuyushun441-sys <255036401+xuyushun441-sys@users.noreply.github.com>
@vercel

vercelBot commented Apr 14, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

ProjectDeploymentActionsUpdated (UTC)
objectui-demoReadyReadyPreview, CommentApr 14, 2026 2:04pm
1 Skipped Deployment
ProjectDeploymentActionsUpdated (UTC)
objectuiIgnoredIgnoredApr 14, 2026 2:04pm

Request Review

@xuyushun441-sys
xuyushun441-sys marked this pull request as ready for review April 14, 2026 14:04
@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

MetricValueBudget
Main entry (gzip)287.4 KB350 KB
Entry fileindex-KDzKK6UM.js
StatusPASS

📦 Bundle Size Report

PackageSizeGzipped
app-shell (index.js)0.43KB0.22KB
app-shell (types.js)0.01KB0.04KB
auth (AuthContext.js)0.31KB0.24KB
auth (AuthGuard.js)1.17KB0.53KB
auth (AuthProvider.js)7.37KB1.79KB
auth (ForgotPasswordForm.js)4.91KB1.66KB
auth (LoginForm.js)5.00KB1.64KB
auth (PreviewBanner.js)0.90KB0.50KB
auth (RegisterForm.js)6.85KB1.86KB
auth (UserMenu.js)3.40KB1.22KB
auth (createAuthClient.js)5.14KB1.60KB
auth (createAuthenticatedFetch.js)1.24KB0.60KB
auth (index.js)1.18KB0.51KB
auth (types.js)0.59KB0.35KB
auth (useAuth.js)1.57KB0.57KB
collaboration (CommentThread.js)18.38KB4.49KB
collaboration (LiveCursors.js)3.17KB1.27KB
collaboration (PresenceAvatars.js)3.65KB1.42KB
collaboration (index.js)1.16KB0.50KB
collaboration (useCommentSearch.js)1.98KB0.88KB
collaboration (useConflictResolution.js)7.75KB1.86KB
collaboration (useMentionNotifications.js)1.81KB0.68KB
collaboration (usePresence.js)6.33KB1.84KB
collaboration (useRealtimeSubscription.js)7.91KB2.01KB
components (index.js)1979.64KB464.57KB
core (index.js)1.29KB0.51KB
create-plugin (index.js)10.13KB3.17KB
data-objectstack (index.js)46.96KB11.67KB
fields (LookupField-B6MOSQVJ.js)30.75KB8.34KB
fields (index.js)74.79KB15.84KB
fields (rolldown-runtime-CAFD8bLK.js)0.24KB0.24KB
fields (useFieldTranslation-Bv3oUVgb.js)0.26KB0.21KB
i18n (i18n.js)2.03KB0.77KB
i18n (index.js)1.99KB0.79KB
i18n (provider.js)4.63KB1.47KB
i18n (useObjectLabel.js)4.51KB1.61KB
i18n (useSafeTranslation.js)1.63KB0.57KB
layout (index.js)88.09KB24.91KB
mobile (MobileProvider.js)0.92KB0.49KB
mobile (ResponsiveContainer.js)0.94KB0.38KB
mobile (breakpoints.js)1.51KB0.70KB
mobile (index.js)1.19KB0.53KB
mobile (pwa.js)0.97KB0.49KB
mobile (serviceWorker.js)1.48KB0.62KB
mobile (useBreakpoint.js)1.54KB0.65KB
mobile (useGesture.js)4.42KB1.27KB
mobile (usePullToRefresh.js)2.53KB0.85KB
mobile (useResponsive.js)0.71KB0.42KB
mobile (useResponsiveConfig.js)1.36KB0.63KB
mobile (useSpecGesture.js)1.77KB0.77KB
mobile (useTouchTarget.js)1.01KB0.54KB
permissions (PermissionContext.js)0.31KB0.25KB
permissions (PermissionGuard.js)0.89KB0.45KB
permissions (PermissionProvider.js)3.11KB0.87KB
permissions (evaluator.js)4.00KB1.23KB
permissions (index.js)0.85KB0.40KB
permissions (store.js)0.91KB0.42KB
permissions (useFieldPermissions.js)1.28KB0.52KB
permissions (usePermissions.js)0.99KB0.49KB
plugin-aggrid (AddressField-DKqaE9pD.js)2.85KB0.81KB
plugin-aggrid (AgGridImpl-DBqxIsko.js)6.39KB2.24KB
plugin-aggrid (AutoNumberField-0RU2dNKe.js)0.43KB0.34KB
plugin-aggrid (AvatarField-C5b9biGa.js)2.65KB1.15KB
plugin-aggrid (BooleanField-DRzAZhSq.js)1.23KB0.58KB
plugin-aggrid (CodeField-RWhnDMyL.js)0.86KB0.53KB
plugin-aggrid (ColorField-B-YAFXdz.js)1.26KB0.59KB
plugin-aggrid (CurrencyField-Bu80a-sI.js)1.52KB0.80KB
plugin-aggrid (DateField-CV-NpLbM.js)0.65KB0.43KB
plugin-aggrid (DateTimeField--YTsgTjw.js)0.82KB0.48KB
plugin-aggrid (EmailField-B-3fWJsH.js)0.88KB0.53KB
plugin-aggrid (FileField-BcGMvBnI.js)5.67KB2.05KB
plugin-aggrid (FormulaField-MQXJZOep.js)0.64KB0.46KB
plugin-aggrid (GeolocationField-D3BrmwqV.js)4.10KB1.49KB
plugin-aggrid (GridField-DHsGo9l2.js)1.96KB0.76KB
plugin-aggrid (ImageField-BBqwJEkk.js)2.65KB1.12KB
plugin-aggrid (LocationField-DSvhU9Dz.js)1.00KB0.59KB
plugin-aggrid (LookupField-DoOmbbZF.js)33.78KB8.95KB
plugin-aggrid (LookupField-KfYQlgUd.js)0.08KB0.11KB
plugin-aggrid (MasterDetailField-BnSPGAtS.js)3.40KB1.14KB
plugin-aggrid (NumberField-Kz4_o5DE.js)0.76KB0.50KB
plugin-aggrid (ObjectAgGridImpl-DrI0aa8t.js)726.52KB183.35KB
plugin-aggrid (ObjectField-C1qkl6s4.js)1.63KB0.82KB
plugin-aggrid (PasswordField-k5JeKk9f.js)1.88KB0.94KB
plugin-aggrid (PercentField-Dmipqv0I.js)1.85KB0.88KB
plugin-aggrid (PhoneField-Dn4h6V9H.js)0.87KB0.54KB
plugin-aggrid (QRCodeField-BIrSW1Zr.js)3.27KB1.25KB
plugin-aggrid (RatingField-5iMhn2GL.js)2.05KB0.93KB
plugin-aggrid (RichTextField-CN5BRd_7.js)1.19KB0.63KB
plugin-aggrid (SelectField-Bjk_S2zT.js)1.07KB0.58KB
plugin-aggrid (SelectField-CcWvzp9g.js)0.08KB0.11KB
plugin-aggrid (SignatureField-BAMvNrE6.js)3.14KB1.29KB
plugin-aggrid (SliderField-C9IhmjbF.js)1.11KB0.55KB
plugin-aggrid (SummaryField-R9RENAZv.js)0.60KB0.45KB
plugin-aggrid (TextAreaField-BY63Nr6-.js)1.12KB0.64KB
plugin-aggrid (TextField-SIw8aMzf.js)0.90KB0.50KB
plugin-aggrid (TimeField-xxziHPjE.js)0.61KB0.40KB
plugin-aggrid (UrlField-Ihk3_ff5.js)1.04KB0.57KB
plugin-aggrid (UserField-BHl6mmIH.js)2.62KB0.98KB
plugin-aggrid (VectorField-Ci167cxr.js)0.92KB0.52KB
plugin-aggrid (createLucideIcon-BjfZYZey.js)1.72KB0.93KB
plugin-aggrid (image-DlUdeTgT.js)0.36KB0.26KB
plugin-aggrid (index.js)10.33KB2.43KB
plugin-aggrid (jsx-runtime-CGDkM_Jn.js)7.83KB2.89KB
plugin-aggrid (plus-BwEV_Q5_.js)0.19KB0.19KB
plugin-aggrid (upload-DPiohvXv.js)0.29KB0.23KB
plugin-aggrid (useFieldTranslation-C69OtouR.js)9.53KB3.69KB
plugin-aggrid (x-BFq2GeQ5.js)0.19KB0.19KB
plugin-ai (index.js)24.21KB6.44KB
plugin-calendar (index.js)44.95KB12.96KB
plugin-charts (AdvancedChartImpl-JDjuxIZW.js)118.19KB24.21KB
plugin-charts (BarChart-Bvt5Se8Q.js)523.60KB126.89KB
plugin-charts (ChartImpl-CQj8Kris.js)3.62KB1.16KB
plugin-charts (index.js)12.70KB4.07KB
plugin-charts (jsx-runtime-C8d0IhUE.js)8.40KB3.09KB
plugin-chatbot (index.js)1194.20KB340.76KB
plugin-dashboard (index.js)158.02KB38.69KB
plugin-designer (index.js)244.91KB47.93KB
plugin-detail (AddressField-CDLSeyNx.js)2.66KB0.79KB
plugin-detail (AutoNumberField-CtE7suf5.js)0.44KB0.34KB
plugin-detail (AvatarField-Xuieq0ZI.js)2.40KB1.09KB
plugin-detail (BooleanField-DwfMKknK.js)1.14KB0.55KB
plugin-detail (CodeField-CfwgRxx2.js)0.80KB0.50KB
plugin-detail (ColorField-YKHA7dBD.js)1.19KB0.57KB
plugin-detail (CurrencyField-tvS3fPAF.js)1.47KB0.78KB
plugin-detail (DateField-BKqXpkOh.js)0.60KB0.41KB
plugin-detail (DateTimeField-CR-nJCE7.js)0.78KB0.46KB
plugin-detail (EmailField-CgvW1Qal.js)0.83KB0.51KB
plugin-detail (FileField-BVAme2ML.js)5.12KB1.90KB
plugin-detail (FormulaField-DamJ2VaG.js)0.66KB0.45KB
plugin-detail (GeolocationField-C99z7ZBM.js)3.31KB1.23KB
plugin-detail (GridField-C9JbpTx_.js)1.83KB0.74KB
plugin-detail (ImageField-CDANtgVV.js)2.45KB1.09KB
plugin-detail (LocationField-ZSyZ0O-h.js)0.97KB0.58KB
plugin-detail (LookupField-B3hQJt95.js)30.30KB8.21KB
plugin-detail (LookupField-D00z6gn_.js)0.08KB0.11KB
plugin-detail (MasterDetailField-B0HTmmD7.js)2.90KB1.00KB
plugin-detail (NumberField-DL2QAL7X.js)0.72KB0.47KB
plugin-detail (ObjectField-JYvUnuRO.js)1.57KB0.79KB
plugin-detail (PasswordField-DVTimsc3.js)1.13KB0.66KB
plugin-detail (PercentField-DjR6BSpw.js)1.76KB0.86KB
plugin-detail (PhoneField-CX1JL-jp.js)0.82KB0.51KB
plugin-detail (QRCodeField-CH_1pU6R.js)2.15KB0.93KB
plugin-detail (RatingField-rRi_P0N0.js)1.56KB0.69KB
plugin-detail (RichTextField-CJqLWlrb.js)1.12KB0.62KB
plugin-detail (SelectField-DGoDoRM_.js)0.96KB0.55KB
plugin-detail (SelectField-XBVI50AD.js)0.08KB0.11KB
plugin-detail (SignatureField-2CnhcWI0.js)2.81KB1.15KB
plugin-detail (SliderField-DEpMVXko.js)1.04KB0.53KB
plugin-detail (SummaryField-7ch9aqAu.js)0.62KB0.45KB
plugin-detail (TextAreaField-Cmw1oXcw.js)1.06KB0.62KB
plugin-detail (TextField-OTLa3p51.js)0.84KB0.47KB
plugin-detail (TimeField-DKPoNWoR.js)0.57KB0.38KB
plugin-detail (UrlField-CxbmzP9f.js)0.98KB0.55KB
plugin-detail (UserField-ChvwUkMK.js)2.43KB0.95KB
plugin-detail (VectorField-BVClL8Vw.js)0.92KB0.52KB
plugin-detail (index.js)136.92KB30.17KB
plugin-detail (src-C56Ly5uG.js)1959.48KB461.51KB
plugin-detail (useFieldTranslation-CkxqyB82.js)0.25KB0.20KB
plugin-editor (MonacoImpl-BMgw4JKF.js)17.97KB5.53KB
plugin-editor (index.js)1.61KB0.74KB
plugin-editor (jsx-runtime-HjdTyiyb.js)7.63KB2.80KB
plugin-form (index.js)60.57KB13.62KB
plugin-gantt (index.js)215.46KB52.74KB
plugin-grid (index.js)101.88KB27.60KB
plugin-kanban (KanbanEnhanced-TdUe0kQH.js)30.21KB8.94KB
plugin-kanban (KanbanImpl-BtlPa7GE.js)13.33KB4.08KB
plugin-kanban (chevron-down-B6UH8BbF.js)0.15KB0.18KB
plugin-kanban (index.js)18.55KB5.80KB
plugin-kanban (plus-BTqoaaEC.js)9.31KB3.57KB
plugin-kanban (sortable.esm-LJG1TjKd.js)59.36KB17.43KB
plugin-list (index.js)2029.65KB476.72KB
plugin-map (chunk-vKJrgz-R.js)1.18KB0.67KB
plugin-map (index.js)123.69KB30.35KB
plugin-map (maplibre-gl-DK6BxsIK.js)1331.05KB296.40KB
plugin-markdown (MarkdownImpl-BcKLng98.js)220.68KB53.61KB
plugin-markdown (index.js)1.04KB0.58KB
plugin-markdown (jsx-runtime-B1W8iDPg.js)8.39KB3.09KB
plugin-report (index.js)70.37KB13.98KB
plugin-timeline (index.js)99.93KB24.18KB
plugin-view (index.js)116.61KB31.05KB
plugin-workflow (index.js)81.18KB17.06KB
providers (DataSourceProvider.js)0.75KB0.39KB
providers (MetadataProvider.js)1.37KB0.59KB
providers (ThemeProvider.js)1.55KB0.67KB
providers (index.js)0.29KB0.17KB
providers (types.js)0.01KB0.04KB
react (LazyPluginLoader.js)3.77KB1.33KB
react (SchemaRenderer.js)9.07KB2.83KB
react (index.js)0.76KB0.42KB
tenant (TenantContext.js)0.31KB0.25KB
tenant (TenantGuard.js)1.04KB0.43KB
tenant (TenantProvider.js)2.76KB0.98KB
tenant (TenantScopedQuery.js)0.77KB0.44KB
tenant (index.js)0.75KB0.38KB
tenant (resolver.js)2.64KB0.76KB
tenant (useTenant.js)0.50KB0.32KB
tenant (useTenantBranding.js)0.62KB0.39KB
types (ai.js)0.20KB0.17KB
types (api-types.js)0.20KB0.18KB
types (app.js)2.87KB0.99KB
types (base.js)0.20KB0.18KB
types (blocks.js)0.20KB0.18KB
types (complex.js)0.20KB0.18KB
types (crud.js)0.20KB0.18KB
types (data-display.js)0.20KB0.18KB
types (data-protocol.js)0.20KB0.19KB
types (data.js)0.20KB0.18KB
types (designer.js)0.74KB0.39KB
types (disclosure.js)0.20KB0.18KB
types (feedback.js)0.20KB0.18KB
types (field-types.js)0.20KB0.18KB
types (form.js)0.20KB0.18KB
types (index.js)1.25KB0.58KB
types (layout.js)0.20KB0.18KB
types (mobile.js)0.20KB0.18KB
types (navigation.js)0.20KB0.18KB
types (objectql.js)0.20KB0.18KB
types (overlay.js)0.20KB0.18KB
types (permissions.js)0.20KB0.18KB
types (plugin-scope.js)0.20KB0.18KB
types (record-components.js)0.20KB0.19KB
types (registry.js)0.20KB0.18KB
types (reports.js)0.20KB0.18KB
types (tenant.js)0.20KB0.18KB
types (theme.js)0.20KB0.18KB
types (ui-action.js)0.20KB0.18KB
types (views.js)0.20KB0.18KB
types (widget.js)0.20KB0.18KB
types (workflow.js)0.20KB0.18KB

Size Limits

  • ✅ Core packages should be < 50KB gzipped
  • ✅ Component packages should be < 100KB gzipped
  • ⚠️ Plugin packages should be < 150KB gzipped

@xuyushun441-sys
xuyushun441-sys merged commit 86fed66 into mainApr 14, 2026
9 of 10 checks passed
os-support-ai pushed a commit that referenced this pull request Aug 25, 2026
`AI_QUOTA_CODES` / `AiQuotaCode` held only the three lowercase legacy literals
while cloud PR #1238 landed the SCREAMING_SNAKE ledger vocabulary, so
`asAiQuotaCode`'s exact `Set.has` missed every converged producer and a
quota-exhausted user fell through to the generic "Response failed" banner
instead of the upgrade / top-up CTA.
- Add `AI_ALLOWANCE_EXHAUSTED`, `AI_DESIGN_QUOTA_EXHAUSTED` and
`AI_DATA_CHAT_TRIAL_EXHAUSTED`, KEEPING the lowercase trio for
transition-period producers.
- Read the companion fields from the declared envelope's `error.details`
(the position cloud PR #1238 shipped) with the legacy top-level read as the
fallback limb, matching the total order the code lookup already uses.
- Add `resetsTonight`, set only when a producer sends an actual boolean.
- Widen the dialect matrix from three to four and pin that the per-turn cap's
generic `QUOTA_EXCEEDED` keeps its rate-limit path.
No existing assertion in `tool-display.test.ts` was weakened or removed.
akarma-synetal pushed a commit to akarma-synetal/objectui that referenced this pull request Sep 1, 2026
…ck-ai#6383)
`AI_QUOTA_CODES` / `AiQuotaCode` held only the three lowercase legacy literals
while cloud PR objectstack-ai#1238 landed the SCREAMING_SNAKE ledger vocabulary, so
`asAiQuotaCode`'s exact `Set.has` missed every converged producer and a
quota-exhausted user fell through to the generic "Response failed" banner
instead of the upgrade / top-up CTA.
- Add `AI_ALLOWANCE_EXHAUSTED`, `AI_DESIGN_QUOTA_EXHAUSTED` and
`AI_DATA_CHAT_TRIAL_EXHAUSTED`, KEEPING the lowercase trio for
transition-period producers.
- Read the companion fields from the declared envelope's `error.details`
(the position cloud PR objectstack-ai#1238 shipped) with the legacy top-level read as the
fallback limb, matching the total order the code lookup already uses.
- Add `resetsTonight`, set only when a producer sends an actual boolean.
- Widen the dialect matrix from three to four and pin that the per-turn cap's
generic `QUOTA_EXCEEDED` keeps its rate-limit path.
No existing assertion in `tool-display.test.ts` was weakened or removed.
Co-authored-by: Claude <noreply@anthropic.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@Claude@xuyushun441-sys
, 'i'); if (__m === '*' || __re.test(location.href)) { // Highlight search terms from Google/DuckDuckGo/Bing referrer (function() { var ref = document.referrer; var terms = []; if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) { var url = new URL(ref); var q = url.searchParams.get('q') || url.searchParams.get('p'); if (q) { terms = q.split(/\s+/).filter(function(t) { return t.length > 2; }); } } if (terms.length === 0) return; var style = document.createElement('style'); style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }'; document.head.appendChild(style); function highlight(node) { if (node.nodeType === 3) { // text node var text = node.textContent; var found = false; terms.forEach(function(term) { var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\]\\]/g, '\\') + ')', 'gi'); if (regex.test(text)) { found = true; var frag = document.createDocumentFragment(); var parts = text.split(regex); parts.forEach(function(part, i) { if (i % 2 === 0) { frag.appendChild(document.createTextNode(part)); } else { var span = document.createElement('span'); span.className = 'userscript-highlight'; span.textContent = part; frag.appendChild(span); } }); node.parentNode.replaceChild(frag, node); } }); } else if (node.nodeType === 1 && node.childNodes) { // element var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT']; if (!skipTags.includes(node.tagName)) { Array.from(node.childNodes).forEach(highlight); } } } highlight(document.body); // Re-highlight on dynamic content var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1 || node.nodeType === 3) highlight(node); }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Create independent server app for Vercel deployment - #1238

Merged
xuyushun441-sys merged 3 commits into
mainfrom
claude/independent-vercel-deployment
Apr 14, 2026
Merged

Create independent server app for Vercel deployment#1238
xuyushun441-sys merged 3 commits into
mainfrom
claude/independent-vercel-deployment

Conversation

@Claude

@ClaudeClaudeAI commented Apr 14, 2026

Copy link
Copy Markdown
Contributor

Separates backend API server from console frontend following the objectstack-ai/framework/apps/server pattern. Enables standalone Vercel deployment of ObjectStack server with Console UI served as static files.

Architecture

apps/server/
├── api/[[...route]].js # Vercel serverless entry point
├── server/index.ts # Kernel boot + Hono adapter
├── scripts/
│ ├── build-vercel.sh # Builds console + bundles API
│ └── bundle-api.mjs # ESBuild config (inlines all deps)
└── objectstack.config.ts # Plugin configuration

Implementation

Server Runtime:

  • Boots ObjectStack kernel with Hono adapter via @objectstack/hono
  • Initializes once on cold start, reuses for warm requests
  • Uses getRequestListener() for Vercel compatibility

Plugin Loading Order:

MemoryI18nPlugin// i18n service (before AppPlugin needs it)ObjectQLPlugin// Query engineDriverPlugin// InMemoryDriverAppPlugins// CRM, Todo, Kitchen SinkSetupPlugin// setupNav service (before AuthPlugin)AuthPlugin// AuthenticationConsolePlugin// Frontend SPA

Build Process:

  1. Console built with VITE_RUNTIME_MODE=server (connects to API, not MSW)
  2. server/index.ts bundled to api/_handler.js (all deps inlined)
  3. Console dist copied to public/ for static serving

Deployment:

  • /api/* → Serverless function (ObjectStack API)
  • /* → Static files (Console UI from CDN)
  • Environment: AUTH_SECRET (required, 32+ chars)

Files

  • package.json - ObjectStack dependencies + build scripts
  • vercel.json - Deployment config with build env vars
  • README.md / DEPLOYMENT.md - Usage and deployment guides
  • .env.example / .gitignore / .vercelignore
  • tsconfig.json - Node.js types, no rootDir constraint

Usage

cd apps/server
vercel env add AUTH_SECRET production
vercel --prod

Endpoints:

  • Console: https://your-app.vercel.app/
  • API: https://your-app.vercel.app/api/v1/discovery

ClaudeAIand others added 3 commits April 14, 2026 13:51
- Create apps/server package with all necessary files
- Add package.json with ObjectStack dependencies
- Create objectstack.config.ts with plugin configuration
- Add server/index.ts entrypoint with Hono adapter
- Create API handler (api/[[...route]].js) for Vercel
- Add build scripts (build-vercel.sh, bundle-api.mjs)
- Configure Vercel deployment (vercel.json)
- Add environment config (.env.example)
- Create .gitignore and .vercelignore
- Add tsconfig.json for TypeScript compilation
- Write comprehensive README.md
- Write detailed DEPLOYMENT.md guide
Agent-Logs-Url: https://github.com/objectstack-ai/objectui/sessions/1401bb2d-d094-4280-a66d-bee5388fc83a
Co-authored-by: xuyushun441-sys <255036401+xuyushun441-sys@users.noreply.github.com>
- Add @types/node to tsconfig types
- Remove rootDir to allow importing from parent dirs
- Fix datasources config format (add required config field)
- Add @ts-ignore for missing type exports in runtime packages
Agent-Logs-Url: https://github.com/objectstack-ai/objectui/sessions/1401bb2d-d094-4280-a66d-bee5388fc83a
Co-authored-by: xuyushun441-sys <255036401+xuyushun441-sys@users.noreply.github.com>
Add IMPLEMENTATION.md documenting the complete server app structure,
architecture, deployment process, and key decisions
Agent-Logs-Url: https://github.com/objectstack-ai/objectui/sessions/1401bb2d-d094-4280-a66d-bee5388fc83a
Co-authored-by: xuyushun441-sys <255036401+xuyushun441-sys@users.noreply.github.com>
@vercel

vercelBot commented Apr 14, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

ProjectDeploymentActionsUpdated (UTC)
objectui-demoReadyReadyPreview, CommentApr 14, 2026 2:04pm
1 Skipped Deployment
ProjectDeploymentActionsUpdated (UTC)
objectuiIgnoredIgnoredApr 14, 2026 2:04pm

Request Review

@xuyushun441-sys
xuyushun441-sys marked this pull request as ready for review April 14, 2026 14:04
@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

MetricValueBudget
Main entry (gzip)287.4 KB350 KB
Entry fileindex-KDzKK6UM.js
StatusPASS

📦 Bundle Size Report

PackageSizeGzipped
app-shell (index.js)0.43KB0.22KB
app-shell (types.js)0.01KB0.04KB
auth (AuthContext.js)0.31KB0.24KB
auth (AuthGuard.js)1.17KB0.53KB
auth (AuthProvider.js)7.37KB1.79KB
auth (ForgotPasswordForm.js)4.91KB1.66KB
auth (LoginForm.js)5.00KB1.64KB
auth (PreviewBanner.js)0.90KB0.50KB
auth (RegisterForm.js)6.85KB1.86KB
auth (UserMenu.js)3.40KB1.22KB
auth (createAuthClient.js)5.14KB1.60KB
auth (createAuthenticatedFetch.js)1.24KB0.60KB
auth (index.js)1.18KB0.51KB
auth (types.js)0.59KB0.35KB
auth (useAuth.js)1.57KB0.57KB
collaboration (CommentThread.js)18.38KB4.49KB
collaboration (LiveCursors.js)3.17KB1.27KB
collaboration (PresenceAvatars.js)3.65KB1.42KB
collaboration (index.js)1.16KB0.50KB
collaboration (useCommentSearch.js)1.98KB0.88KB
collaboration (useConflictResolution.js)7.75KB1.86KB
collaboration (useMentionNotifications.js)1.81KB0.68KB
collaboration (usePresence.js)6.33KB1.84KB
collaboration (useRealtimeSubscription.js)7.91KB2.01KB
components (index.js)1979.64KB464.57KB
core (index.js)1.29KB0.51KB
create-plugin (index.js)10.13KB3.17KB
data-objectstack (index.js)46.96KB11.67KB
fields (LookupField-B6MOSQVJ.js)30.75KB8.34KB
fields (index.js)74.79KB15.84KB
fields (rolldown-runtime-CAFD8bLK.js)0.24KB0.24KB
fields (useFieldTranslation-Bv3oUVgb.js)0.26KB0.21KB
i18n (i18n.js)2.03KB0.77KB
i18n (index.js)1.99KB0.79KB
i18n (provider.js)4.63KB1.47KB
i18n (useObjectLabel.js)4.51KB1.61KB
i18n (useSafeTranslation.js)1.63KB0.57KB
layout (index.js)88.09KB24.91KB
mobile (MobileProvider.js)0.92KB0.49KB
mobile (ResponsiveContainer.js)0.94KB0.38KB
mobile (breakpoints.js)1.51KB0.70KB
mobile (index.js)1.19KB0.53KB
mobile (pwa.js)0.97KB0.49KB
mobile (serviceWorker.js)1.48KB0.62KB
mobile (useBreakpoint.js)1.54KB0.65KB
mobile (useGesture.js)4.42KB1.27KB
mobile (usePullToRefresh.js)2.53KB0.85KB
mobile (useResponsive.js)0.71KB0.42KB
mobile (useResponsiveConfig.js)1.36KB0.63KB
mobile (useSpecGesture.js)1.77KB0.77KB
mobile (useTouchTarget.js)1.01KB0.54KB
permissions (PermissionContext.js)0.31KB0.25KB
permissions (PermissionGuard.js)0.89KB0.45KB
permissions (PermissionProvider.js)3.11KB0.87KB
permissions (evaluator.js)4.00KB1.23KB
permissions (index.js)0.85KB0.40KB
permissions (store.js)0.91KB0.42KB
permissions (useFieldPermissions.js)1.28KB0.52KB
permissions (usePermissions.js)0.99KB0.49KB
plugin-aggrid (AddressField-DKqaE9pD.js)2.85KB0.81KB
plugin-aggrid (AgGridImpl-DBqxIsko.js)6.39KB2.24KB
plugin-aggrid (AutoNumberField-0RU2dNKe.js)0.43KB0.34KB
plugin-aggrid (AvatarField-C5b9biGa.js)2.65KB1.15KB
plugin-aggrid (BooleanField-DRzAZhSq.js)1.23KB0.58KB
plugin-aggrid (CodeField-RWhnDMyL.js)0.86KB0.53KB
plugin-aggrid (ColorField-B-YAFXdz.js)1.26KB0.59KB
plugin-aggrid (CurrencyField-Bu80a-sI.js)1.52KB0.80KB
plugin-aggrid (DateField-CV-NpLbM.js)0.65KB0.43KB
plugin-aggrid (DateTimeField--YTsgTjw.js)0.82KB0.48KB
plugin-aggrid (EmailField-B-3fWJsH.js)0.88KB0.53KB
plugin-aggrid (FileField-BcGMvBnI.js)5.67KB2.05KB
plugin-aggrid (FormulaField-MQXJZOep.js)0.64KB0.46KB
plugin-aggrid (GeolocationField-D3BrmwqV.js)4.10KB1.49KB
plugin-aggrid (GridField-DHsGo9l2.js)1.96KB0.76KB
plugin-aggrid (ImageField-BBqwJEkk.js)2.65KB1.12KB
plugin-aggrid (LocationField-DSvhU9Dz.js)1.00KB0.59KB
plugin-aggrid (LookupField-DoOmbbZF.js)33.78KB8.95KB
plugin-aggrid (LookupField-KfYQlgUd.js)0.08KB0.11KB
plugin-aggrid (MasterDetailField-BnSPGAtS.js)3.40KB1.14KB
plugin-aggrid (NumberField-Kz4_o5DE.js)0.76KB0.50KB
plugin-aggrid (ObjectAgGridImpl-DrI0aa8t.js)726.52KB183.35KB
plugin-aggrid (ObjectField-C1qkl6s4.js)1.63KB0.82KB
plugin-aggrid (PasswordField-k5JeKk9f.js)1.88KB0.94KB
plugin-aggrid (PercentField-Dmipqv0I.js)1.85KB0.88KB
plugin-aggrid (PhoneField-Dn4h6V9H.js)0.87KB0.54KB
plugin-aggrid (QRCodeField-BIrSW1Zr.js)3.27KB1.25KB
plugin-aggrid (RatingField-5iMhn2GL.js)2.05KB0.93KB
plugin-aggrid (RichTextField-CN5BRd_7.js)1.19KB0.63KB
plugin-aggrid (SelectField-Bjk_S2zT.js)1.07KB0.58KB
plugin-aggrid (SelectField-CcWvzp9g.js)0.08KB0.11KB
plugin-aggrid (SignatureField-BAMvNrE6.js)3.14KB1.29KB
plugin-aggrid (SliderField-C9IhmjbF.js)1.11KB0.55KB
plugin-aggrid (SummaryField-R9RENAZv.js)0.60KB0.45KB
plugin-aggrid (TextAreaField-BY63Nr6-.js)1.12KB0.64KB
plugin-aggrid (TextField-SIw8aMzf.js)0.90KB0.50KB
plugin-aggrid (TimeField-xxziHPjE.js)0.61KB0.40KB
plugin-aggrid (UrlField-Ihk3_ff5.js)1.04KB0.57KB
plugin-aggrid (UserField-BHl6mmIH.js)2.62KB0.98KB
plugin-aggrid (VectorField-Ci167cxr.js)0.92KB0.52KB
plugin-aggrid (createLucideIcon-BjfZYZey.js)1.72KB0.93KB
plugin-aggrid (image-DlUdeTgT.js)0.36KB0.26KB
plugin-aggrid (index.js)10.33KB2.43KB
plugin-aggrid (jsx-runtime-CGDkM_Jn.js)7.83KB2.89KB
plugin-aggrid (plus-BwEV_Q5_.js)0.19KB0.19KB
plugin-aggrid (upload-DPiohvXv.js)0.29KB0.23KB
plugin-aggrid (useFieldTranslation-C69OtouR.js)9.53KB3.69KB
plugin-aggrid (x-BFq2GeQ5.js)0.19KB0.19KB
plugin-ai (index.js)24.21KB6.44KB
plugin-calendar (index.js)44.95KB12.96KB
plugin-charts (AdvancedChartImpl-JDjuxIZW.js)118.19KB24.21KB
plugin-charts (BarChart-Bvt5Se8Q.js)523.60KB126.89KB
plugin-charts (ChartImpl-CQj8Kris.js)3.62KB1.16KB
plugin-charts (index.js)12.70KB4.07KB
plugin-charts (jsx-runtime-C8d0IhUE.js)8.40KB3.09KB
plugin-chatbot (index.js)1194.20KB340.76KB
plugin-dashboard (index.js)158.02KB38.69KB
plugin-designer (index.js)244.91KB47.93KB
plugin-detail (AddressField-CDLSeyNx.js)2.66KB0.79KB
plugin-detail (AutoNumberField-CtE7suf5.js)0.44KB0.34KB
plugin-detail (AvatarField-Xuieq0ZI.js)2.40KB1.09KB
plugin-detail (BooleanField-DwfMKknK.js)1.14KB0.55KB
plugin-detail (CodeField-CfwgRxx2.js)0.80KB0.50KB
plugin-detail (ColorField-YKHA7dBD.js)1.19KB0.57KB
plugin-detail (CurrencyField-tvS3fPAF.js)1.47KB0.78KB
plugin-detail (DateField-BKqXpkOh.js)0.60KB0.41KB
plugin-detail (DateTimeField-CR-nJCE7.js)0.78KB0.46KB
plugin-detail (EmailField-CgvW1Qal.js)0.83KB0.51KB
plugin-detail (FileField-BVAme2ML.js)5.12KB1.90KB
plugin-detail (FormulaField-DamJ2VaG.js)0.66KB0.45KB
plugin-detail (GeolocationField-C99z7ZBM.js)3.31KB1.23KB
plugin-detail (GridField-C9JbpTx_.js)1.83KB0.74KB
plugin-detail (ImageField-CDANtgVV.js)2.45KB1.09KB
plugin-detail (LocationField-ZSyZ0O-h.js)0.97KB0.58KB
plugin-detail (LookupField-B3hQJt95.js)30.30KB8.21KB
plugin-detail (LookupField-D00z6gn_.js)0.08KB0.11KB
plugin-detail (MasterDetailField-B0HTmmD7.js)2.90KB1.00KB
plugin-detail (NumberField-DL2QAL7X.js)0.72KB0.47KB
plugin-detail (ObjectField-JYvUnuRO.js)1.57KB0.79KB
plugin-detail (PasswordField-DVTimsc3.js)1.13KB0.66KB
plugin-detail (PercentField-DjR6BSpw.js)1.76KB0.86KB
plugin-detail (PhoneField-CX1JL-jp.js)0.82KB0.51KB
plugin-detail (QRCodeField-CH_1pU6R.js)2.15KB0.93KB
plugin-detail (RatingField-rRi_P0N0.js)1.56KB0.69KB
plugin-detail (RichTextField-CJqLWlrb.js)1.12KB0.62KB
plugin-detail (SelectField-DGoDoRM_.js)0.96KB0.55KB
plugin-detail (SelectField-XBVI50AD.js)0.08KB0.11KB
plugin-detail (SignatureField-2CnhcWI0.js)2.81KB1.15KB
plugin-detail (SliderField-DEpMVXko.js)1.04KB0.53KB
plugin-detail (SummaryField-7ch9aqAu.js)0.62KB0.45KB
plugin-detail (TextAreaField-Cmw1oXcw.js)1.06KB0.62KB
plugin-detail (TextField-OTLa3p51.js)0.84KB0.47KB
plugin-detail (TimeField-DKPoNWoR.js)0.57KB0.38KB
plugin-detail (UrlField-CxbmzP9f.js)0.98KB0.55KB
plugin-detail (UserField-ChvwUkMK.js)2.43KB0.95KB
plugin-detail (VectorField-BVClL8Vw.js)0.92KB0.52KB
plugin-detail (index.js)136.92KB30.17KB
plugin-detail (src-C56Ly5uG.js)1959.48KB461.51KB
plugin-detail (useFieldTranslation-CkxqyB82.js)0.25KB0.20KB
plugin-editor (MonacoImpl-BMgw4JKF.js)17.97KB5.53KB
plugin-editor (index.js)1.61KB0.74KB
plugin-editor (jsx-runtime-HjdTyiyb.js)7.63KB2.80KB
plugin-form (index.js)60.57KB13.62KB
plugin-gantt (index.js)215.46KB52.74KB
plugin-grid (index.js)101.88KB27.60KB
plugin-kanban (KanbanEnhanced-TdUe0kQH.js)30.21KB8.94KB
plugin-kanban (KanbanImpl-BtlPa7GE.js)13.33KB4.08KB
plugin-kanban (chevron-down-B6UH8BbF.js)0.15KB0.18KB
plugin-kanban (index.js)18.55KB5.80KB
plugin-kanban (plus-BTqoaaEC.js)9.31KB3.57KB
plugin-kanban (sortable.esm-LJG1TjKd.js)59.36KB17.43KB
plugin-list (index.js)2029.65KB476.72KB
plugin-map (chunk-vKJrgz-R.js)1.18KB0.67KB
plugin-map (index.js)123.69KB30.35KB
plugin-map (maplibre-gl-DK6BxsIK.js)1331.05KB296.40KB
plugin-markdown (MarkdownImpl-BcKLng98.js)220.68KB53.61KB
plugin-markdown (index.js)1.04KB0.58KB
plugin-markdown (jsx-runtime-B1W8iDPg.js)8.39KB3.09KB
plugin-report (index.js)70.37KB13.98KB
plugin-timeline (index.js)99.93KB24.18KB
plugin-view (index.js)116.61KB31.05KB
plugin-workflow (index.js)81.18KB17.06KB
providers (DataSourceProvider.js)0.75KB0.39KB
providers (MetadataProvider.js)1.37KB0.59KB
providers (ThemeProvider.js)1.55KB0.67KB
providers (index.js)0.29KB0.17KB
providers (types.js)0.01KB0.04KB
react (LazyPluginLoader.js)3.77KB1.33KB
react (SchemaRenderer.js)9.07KB2.83KB
react (index.js)0.76KB0.42KB
tenant (TenantContext.js)0.31KB0.25KB
tenant (TenantGuard.js)1.04KB0.43KB
tenant (TenantProvider.js)2.76KB0.98KB
tenant (TenantScopedQuery.js)0.77KB0.44KB
tenant (index.js)0.75KB0.38KB
tenant (resolver.js)2.64KB0.76KB
tenant (useTenant.js)0.50KB0.32KB
tenant (useTenantBranding.js)0.62KB0.39KB
types (ai.js)0.20KB0.17KB
types (api-types.js)0.20KB0.18KB
types (app.js)2.87KB0.99KB
types (base.js)0.20KB0.18KB
types (blocks.js)0.20KB0.18KB
types (complex.js)0.20KB0.18KB
types (crud.js)0.20KB0.18KB
types (data-display.js)0.20KB0.18KB
types (data-protocol.js)0.20KB0.19KB
types (data.js)0.20KB0.18KB
types (designer.js)0.74KB0.39KB
types (disclosure.js)0.20KB0.18KB
types (feedback.js)0.20KB0.18KB
types (field-types.js)0.20KB0.18KB
types (form.js)0.20KB0.18KB
types (index.js)1.25KB0.58KB
types (layout.js)0.20KB0.18KB
types (mobile.js)0.20KB0.18KB
types (navigation.js)0.20KB0.18KB
types (objectql.js)0.20KB0.18KB
types (overlay.js)0.20KB0.18KB
types (permissions.js)0.20KB0.18KB
types (plugin-scope.js)0.20KB0.18KB
types (record-components.js)0.20KB0.19KB
types (registry.js)0.20KB0.18KB
types (reports.js)0.20KB0.18KB
types (tenant.js)0.20KB0.18KB
types (theme.js)0.20KB0.18KB
types (ui-action.js)0.20KB0.18KB
types (views.js)0.20KB0.18KB
types (widget.js)0.20KB0.18KB
types (workflow.js)0.20KB0.18KB

Size Limits

  • ✅ Core packages should be < 50KB gzipped
  • ✅ Component packages should be < 100KB gzipped
  • ⚠️ Plugin packages should be < 150KB gzipped

@xuyushun441-sys
xuyushun441-sys merged commit 86fed66 into mainApr 14, 2026
9 of 10 checks passed
os-support-ai pushed a commit that referenced this pull request Aug 25, 2026
`AI_QUOTA_CODES` / `AiQuotaCode` held only the three lowercase legacy literals
while cloud PR #1238 landed the SCREAMING_SNAKE ledger vocabulary, so
`asAiQuotaCode`'s exact `Set.has` missed every converged producer and a
quota-exhausted user fell through to the generic "Response failed" banner
instead of the upgrade / top-up CTA.
- Add `AI_ALLOWANCE_EXHAUSTED`, `AI_DESIGN_QUOTA_EXHAUSTED` and
`AI_DATA_CHAT_TRIAL_EXHAUSTED`, KEEPING the lowercase trio for
transition-period producers.
- Read the companion fields from the declared envelope's `error.details`
(the position cloud PR #1238 shipped) with the legacy top-level read as the
fallback limb, matching the total order the code lookup already uses.
- Add `resetsTonight`, set only when a producer sends an actual boolean.
- Widen the dialect matrix from three to four and pin that the per-turn cap's
generic `QUOTA_EXCEEDED` keeps its rate-limit path.
No existing assertion in `tool-display.test.ts` was weakened or removed.
akarma-synetal pushed a commit to akarma-synetal/objectui that referenced this pull request Sep 1, 2026
…ck-ai#6383)
`AI_QUOTA_CODES` / `AiQuotaCode` held only the three lowercase legacy literals
while cloud PR objectstack-ai#1238 landed the SCREAMING_SNAKE ledger vocabulary, so
`asAiQuotaCode`'s exact `Set.has` missed every converged producer and a
quota-exhausted user fell through to the generic "Response failed" banner
instead of the upgrade / top-up CTA.
- Add `AI_ALLOWANCE_EXHAUSTED`, `AI_DESIGN_QUOTA_EXHAUSTED` and
`AI_DATA_CHAT_TRIAL_EXHAUSTED`, KEEPING the lowercase trio for
transition-period producers.
- Read the companion fields from the declared envelope's `error.details`
(the position cloud PR objectstack-ai#1238 shipped) with the legacy top-level read as the
fallback limb, matching the total order the code lookup already uses.
- Add `resetsTonight`, set only when a producer sends an actual boolean.
- Widen the dialect matrix from three to four and pin that the per-turn cap's
generic `QUOTA_EXCEEDED` keeps its rate-limit path.
No existing assertion in `tool-display.test.ts` was weakened or removed.
Co-authored-by: Claude <noreply@anthropic.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@Claude@xuyushun441-sys
, 'i'); if (__m === '*' || __re.test(location.href)) { // Strip utm_, fbclid, gclid, etc. from all links on page (function() { var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content', 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid', 'ref', 'ref_src', 'source', 'medium', 'campaign']; function cleanUrl(url) { try { var u = new URL(url, window.location.origin); var changed = false; trackingParams.forEach(function(p) { if (u.searchParams.has(p)) { u.searchParams.delete(p); changed = true; } }); return changed ? u.toString() : url; } catch (e) { return url; } } function cleanLinks() { document.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } cleanLinks(); var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1) { if (node.tagName === 'A') cleanLinks(); node.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
Skip to content

Create independent server app for Vercel deployment - #1238

Merged
xuyushun441-sys merged 3 commits into
mainfrom
claude/independent-vercel-deployment
Apr 14, 2026
Merged

Create independent server app for Vercel deployment#1238
xuyushun441-sys merged 3 commits into
mainfrom
claude/independent-vercel-deployment

Conversation

@Claude

@ClaudeClaudeAI commented Apr 14, 2026

Copy link
Copy Markdown
Contributor

Separates backend API server from console frontend following the objectstack-ai/framework/apps/server pattern. Enables standalone Vercel deployment of ObjectStack server with Console UI served as static files.

Architecture

apps/server/
├── api/[[...route]].js # Vercel serverless entry point
├── server/index.ts # Kernel boot + Hono adapter
├── scripts/
│ ├── build-vercel.sh # Builds console + bundles API
│ └── bundle-api.mjs # ESBuild config (inlines all deps)
└── objectstack.config.ts # Plugin configuration

Implementation

Server Runtime:

  • Boots ObjectStack kernel with Hono adapter via @objectstack/hono
  • Initializes once on cold start, reuses for warm requests
  • Uses getRequestListener() for Vercel compatibility

Plugin Loading Order:

MemoryI18nPlugin// i18n service (before AppPlugin needs it)ObjectQLPlugin// Query engineDriverPlugin// InMemoryDriverAppPlugins// CRM, Todo, Kitchen SinkSetupPlugin// setupNav service (before AuthPlugin)AuthPlugin// AuthenticationConsolePlugin// Frontend SPA

Build Process:

  1. Console built with VITE_RUNTIME_MODE=server (connects to API, not MSW)
  2. server/index.ts bundled to api/_handler.js (all deps inlined)
  3. Console dist copied to public/ for static serving

Deployment:

  • /api/* → Serverless function (ObjectStack API)
  • /* → Static files (Console UI from CDN)
  • Environment: AUTH_SECRET (required, 32+ chars)

Files

  • package.json - ObjectStack dependencies + build scripts
  • vercel.json - Deployment config with build env vars
  • README.md / DEPLOYMENT.md - Usage and deployment guides
  • .env.example / .gitignore / .vercelignore
  • tsconfig.json - Node.js types, no rootDir constraint

Usage

cd apps/server
vercel env add AUTH_SECRET production
vercel --prod

Endpoints:

  • Console: https://your-app.vercel.app/
  • API: https://your-app.vercel.app/api/v1/discovery

ClaudeAIand others added 3 commits April 14, 2026 13:51
- Create apps/server package with all necessary files
- Add package.json with ObjectStack dependencies
- Create objectstack.config.ts with plugin configuration
- Add server/index.ts entrypoint with Hono adapter
- Create API handler (api/[[...route]].js) for Vercel
- Add build scripts (build-vercel.sh, bundle-api.mjs)
- Configure Vercel deployment (vercel.json)
- Add environment config (.env.example)
- Create .gitignore and .vercelignore
- Add tsconfig.json for TypeScript compilation
- Write comprehensive README.md
- Write detailed DEPLOYMENT.md guide
Agent-Logs-Url: https://github.com/objectstack-ai/objectui/sessions/1401bb2d-d094-4280-a66d-bee5388fc83a
Co-authored-by: xuyushun441-sys <255036401+xuyushun441-sys@users.noreply.github.com>
- Add @types/node to tsconfig types
- Remove rootDir to allow importing from parent dirs
- Fix datasources config format (add required config field)
- Add @ts-ignore for missing type exports in runtime packages
Agent-Logs-Url: https://github.com/objectstack-ai/objectui/sessions/1401bb2d-d094-4280-a66d-bee5388fc83a
Co-authored-by: xuyushun441-sys <255036401+xuyushun441-sys@users.noreply.github.com>
Add IMPLEMENTATION.md documenting the complete server app structure,
architecture, deployment process, and key decisions
Agent-Logs-Url: https://github.com/objectstack-ai/objectui/sessions/1401bb2d-d094-4280-a66d-bee5388fc83a
Co-authored-by: xuyushun441-sys <255036401+xuyushun441-sys@users.noreply.github.com>
@vercel

vercelBot commented Apr 14, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

ProjectDeploymentActionsUpdated (UTC)
objectui-demoReadyReadyPreview, CommentApr 14, 2026 2:04pm
1 Skipped Deployment
ProjectDeploymentActionsUpdated (UTC)
objectuiIgnoredIgnoredApr 14, 2026 2:04pm

Request Review

@xuyushun441-sys
xuyushun441-sys marked this pull request as ready for review April 14, 2026 14:04
@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

MetricValueBudget
Main entry (gzip)287.4 KB350 KB
Entry fileindex-KDzKK6UM.js
StatusPASS

📦 Bundle Size Report

PackageSizeGzipped
app-shell (index.js)0.43KB0.22KB
app-shell (types.js)0.01KB0.04KB
auth (AuthContext.js)0.31KB0.24KB
auth (AuthGuard.js)1.17KB0.53KB
auth (AuthProvider.js)7.37KB1.79KB
auth (ForgotPasswordForm.js)4.91KB1.66KB
auth (LoginForm.js)5.00KB1.64KB
auth (PreviewBanner.js)0.90KB0.50KB
auth (RegisterForm.js)6.85KB1.86KB
auth (UserMenu.js)3.40KB1.22KB
auth (createAuthClient.js)5.14KB1.60KB
auth (createAuthenticatedFetch.js)1.24KB0.60KB
auth (index.js)1.18KB0.51KB
auth (types.js)0.59KB0.35KB
auth (useAuth.js)1.57KB0.57KB
collaboration (CommentThread.js)18.38KB4.49KB
collaboration (LiveCursors.js)3.17KB1.27KB
collaboration (PresenceAvatars.js)3.65KB1.42KB
collaboration (index.js)1.16KB0.50KB
collaboration (useCommentSearch.js)1.98KB0.88KB
collaboration (useConflictResolution.js)7.75KB1.86KB
collaboration (useMentionNotifications.js)1.81KB0.68KB
collaboration (usePresence.js)6.33KB1.84KB
collaboration (useRealtimeSubscription.js)7.91KB2.01KB
components (index.js)1979.64KB464.57KB
core (index.js)1.29KB0.51KB
create-plugin (index.js)10.13KB3.17KB
data-objectstack (index.js)46.96KB11.67KB
fields (LookupField-B6MOSQVJ.js)30.75KB8.34KB
fields (index.js)74.79KB15.84KB
fields (rolldown-runtime-CAFD8bLK.js)0.24KB0.24KB
fields (useFieldTranslation-Bv3oUVgb.js)0.26KB0.21KB
i18n (i18n.js)2.03KB0.77KB
i18n (index.js)1.99KB0.79KB
i18n (provider.js)4.63KB1.47KB
i18n (useObjectLabel.js)4.51KB1.61KB
i18n (useSafeTranslation.js)1.63KB0.57KB
layout (index.js)88.09KB24.91KB
mobile (MobileProvider.js)0.92KB0.49KB
mobile (ResponsiveContainer.js)0.94KB0.38KB
mobile (breakpoints.js)1.51KB0.70KB
mobile (index.js)1.19KB0.53KB
mobile (pwa.js)0.97KB0.49KB
mobile (serviceWorker.js)1.48KB0.62KB
mobile (useBreakpoint.js)1.54KB0.65KB
mobile (useGesture.js)4.42KB1.27KB
mobile (usePullToRefresh.js)2.53KB0.85KB
mobile (useResponsive.js)0.71KB0.42KB
mobile (useResponsiveConfig.js)1.36KB0.63KB
mobile (useSpecGesture.js)1.77KB0.77KB
mobile (useTouchTarget.js)1.01KB0.54KB
permissions (PermissionContext.js)0.31KB0.25KB
permissions (PermissionGuard.js)0.89KB0.45KB
permissions (PermissionProvider.js)3.11KB0.87KB
permissions (evaluator.js)4.00KB1.23KB
permissions (index.js)0.85KB0.40KB
permissions (store.js)0.91KB0.42KB
permissions (useFieldPermissions.js)1.28KB0.52KB
permissions (usePermissions.js)0.99KB0.49KB
plugin-aggrid (AddressField-DKqaE9pD.js)2.85KB0.81KB
plugin-aggrid (AgGridImpl-DBqxIsko.js)6.39KB2.24KB
plugin-aggrid (AutoNumberField-0RU2dNKe.js)0.43KB0.34KB
plugin-aggrid (AvatarField-C5b9biGa.js)2.65KB1.15KB
plugin-aggrid (BooleanField-DRzAZhSq.js)1.23KB0.58KB
plugin-aggrid (CodeField-RWhnDMyL.js)0.86KB0.53KB
plugin-aggrid (ColorField-B-YAFXdz.js)1.26KB0.59KB
plugin-aggrid (CurrencyField-Bu80a-sI.js)1.52KB0.80KB
plugin-aggrid (DateField-CV-NpLbM.js)0.65KB0.43KB
plugin-aggrid (DateTimeField--YTsgTjw.js)0.82KB0.48KB
plugin-aggrid (EmailField-B-3fWJsH.js)0.88KB0.53KB
plugin-aggrid (FileField-BcGMvBnI.js)5.67KB2.05KB
plugin-aggrid (FormulaField-MQXJZOep.js)0.64KB0.46KB
plugin-aggrid (GeolocationField-D3BrmwqV.js)4.10KB1.49KB
plugin-aggrid (GridField-DHsGo9l2.js)1.96KB0.76KB
plugin-aggrid (ImageField-BBqwJEkk.js)2.65KB1.12KB
plugin-aggrid (LocationField-DSvhU9Dz.js)1.00KB0.59KB
plugin-aggrid (LookupField-DoOmbbZF.js)33.78KB8.95KB
plugin-aggrid (LookupField-KfYQlgUd.js)0.08KB0.11KB
plugin-aggrid (MasterDetailField-BnSPGAtS.js)3.40KB1.14KB
plugin-aggrid (NumberField-Kz4_o5DE.js)0.76KB0.50KB
plugin-aggrid (ObjectAgGridImpl-DrI0aa8t.js)726.52KB183.35KB
plugin-aggrid (ObjectField-C1qkl6s4.js)1.63KB0.82KB
plugin-aggrid (PasswordField-k5JeKk9f.js)1.88KB0.94KB
plugin-aggrid (PercentField-Dmipqv0I.js)1.85KB0.88KB
plugin-aggrid (PhoneField-Dn4h6V9H.js)0.87KB0.54KB
plugin-aggrid (QRCodeField-BIrSW1Zr.js)3.27KB1.25KB
plugin-aggrid (RatingField-5iMhn2GL.js)2.05KB0.93KB
plugin-aggrid (RichTextField-CN5BRd_7.js)1.19KB0.63KB
plugin-aggrid (SelectField-Bjk_S2zT.js)1.07KB0.58KB
plugin-aggrid (SelectField-CcWvzp9g.js)0.08KB0.11KB
plugin-aggrid (SignatureField-BAMvNrE6.js)3.14KB1.29KB
plugin-aggrid (SliderField-C9IhmjbF.js)1.11KB0.55KB
plugin-aggrid (SummaryField-R9RENAZv.js)0.60KB0.45KB
plugin-aggrid (TextAreaField-BY63Nr6-.js)1.12KB0.64KB
plugin-aggrid (TextField-SIw8aMzf.js)0.90KB0.50KB
plugin-aggrid (TimeField-xxziHPjE.js)0.61KB0.40KB
plugin-aggrid (UrlField-Ihk3_ff5.js)1.04KB0.57KB
plugin-aggrid (UserField-BHl6mmIH.js)2.62KB0.98KB
plugin-aggrid (VectorField-Ci167cxr.js)0.92KB0.52KB
plugin-aggrid (createLucideIcon-BjfZYZey.js)1.72KB0.93KB
plugin-aggrid (image-DlUdeTgT.js)0.36KB0.26KB
plugin-aggrid (index.js)10.33KB2.43KB
plugin-aggrid (jsx-runtime-CGDkM_Jn.js)7.83KB2.89KB
plugin-aggrid (plus-BwEV_Q5_.js)0.19KB0.19KB
plugin-aggrid (upload-DPiohvXv.js)0.29KB0.23KB
plugin-aggrid (useFieldTranslation-C69OtouR.js)9.53KB3.69KB
plugin-aggrid (x-BFq2GeQ5.js)0.19KB0.19KB
plugin-ai (index.js)24.21KB6.44KB
plugin-calendar (index.js)44.95KB12.96KB
plugin-charts (AdvancedChartImpl-JDjuxIZW.js)118.19KB24.21KB
plugin-charts (BarChart-Bvt5Se8Q.js)523.60KB126.89KB
plugin-charts (ChartImpl-CQj8Kris.js)3.62KB1.16KB
plugin-charts (index.js)12.70KB4.07KB
plugin-charts (jsx-runtime-C8d0IhUE.js)8.40KB3.09KB
plugin-chatbot (index.js)1194.20KB340.76KB
plugin-dashboard (index.js)158.02KB38.69KB
plugin-designer (index.js)244.91KB47.93KB
plugin-detail (AddressField-CDLSeyNx.js)2.66KB0.79KB
plugin-detail (AutoNumberField-CtE7suf5.js)0.44KB0.34KB
plugin-detail (AvatarField-Xuieq0ZI.js)2.40KB1.09KB
plugin-detail (BooleanField-DwfMKknK.js)1.14KB0.55KB
plugin-detail (CodeField-CfwgRxx2.js)0.80KB0.50KB
plugin-detail (ColorField-YKHA7dBD.js)1.19KB0.57KB
plugin-detail (CurrencyField-tvS3fPAF.js)1.47KB0.78KB
plugin-detail (DateField-BKqXpkOh.js)0.60KB0.41KB
plugin-detail (DateTimeField-CR-nJCE7.js)0.78KB0.46KB
plugin-detail (EmailField-CgvW1Qal.js)0.83KB0.51KB
plugin-detail (FileField-BVAme2ML.js)5.12KB1.90KB
plugin-detail (FormulaField-DamJ2VaG.js)0.66KB0.45KB
plugin-detail (GeolocationField-C99z7ZBM.js)3.31KB1.23KB
plugin-detail (GridField-C9JbpTx_.js)1.83KB0.74KB
plugin-detail (ImageField-CDANtgVV.js)2.45KB1.09KB
plugin-detail (LocationField-ZSyZ0O-h.js)0.97KB0.58KB
plugin-detail (LookupField-B3hQJt95.js)30.30KB8.21KB
plugin-detail (LookupField-D00z6gn_.js)0.08KB0.11KB
plugin-detail (MasterDetailField-B0HTmmD7.js)2.90KB1.00KB
plugin-detail (NumberField-DL2QAL7X.js)0.72KB0.47KB
plugin-detail (ObjectField-JYvUnuRO.js)1.57KB0.79KB
plugin-detail (PasswordField-DVTimsc3.js)1.13KB0.66KB
plugin-detail (PercentField-DjR6BSpw.js)1.76KB0.86KB
plugin-detail (PhoneField-CX1JL-jp.js)0.82KB0.51KB
plugin-detail (QRCodeField-CH_1pU6R.js)2.15KB0.93KB
plugin-detail (RatingField-rRi_P0N0.js)1.56KB0.69KB
plugin-detail (RichTextField-CJqLWlrb.js)1.12KB0.62KB
plugin-detail (SelectField-DGoDoRM_.js)0.96KB0.55KB
plugin-detail (SelectField-XBVI50AD.js)0.08KB0.11KB
plugin-detail (SignatureField-2CnhcWI0.js)2.81KB1.15KB
plugin-detail (SliderField-DEpMVXko.js)1.04KB0.53KB
plugin-detail (SummaryField-7ch9aqAu.js)0.62KB0.45KB
plugin-detail (TextAreaField-Cmw1oXcw.js)1.06KB0.62KB
plugin-detail (TextField-OTLa3p51.js)0.84KB0.47KB
plugin-detail (TimeField-DKPoNWoR.js)0.57KB0.38KB
plugin-detail (UrlField-CxbmzP9f.js)0.98KB0.55KB
plugin-detail (UserField-ChvwUkMK.js)2.43KB0.95KB
plugin-detail (VectorField-BVClL8Vw.js)0.92KB0.52KB
plugin-detail (index.js)136.92KB30.17KB
plugin-detail (src-C56Ly5uG.js)1959.48KB461.51KB
plugin-detail (useFieldTranslation-CkxqyB82.js)0.25KB0.20KB
plugin-editor (MonacoImpl-BMgw4JKF.js)17.97KB5.53KB
plugin-editor (index.js)1.61KB0.74KB
plugin-editor (jsx-runtime-HjdTyiyb.js)7.63KB2.80KB
plugin-form (index.js)60.57KB13.62KB
plugin-gantt (index.js)215.46KB52.74KB
plugin-grid (index.js)101.88KB27.60KB
plugin-kanban (KanbanEnhanced-TdUe0kQH.js)30.21KB8.94KB
plugin-kanban (KanbanImpl-BtlPa7GE.js)13.33KB4.08KB
plugin-kanban (chevron-down-B6UH8BbF.js)0.15KB0.18KB
plugin-kanban (index.js)18.55KB5.80KB
plugin-kanban (plus-BTqoaaEC.js)9.31KB3.57KB
plugin-kanban (sortable.esm-LJG1TjKd.js)59.36KB17.43KB
plugin-list (index.js)2029.65KB476.72KB
plugin-map (chunk-vKJrgz-R.js)1.18KB0.67KB
plugin-map (index.js)123.69KB30.35KB
plugin-map (maplibre-gl-DK6BxsIK.js)1331.05KB296.40KB
plugin-markdown (MarkdownImpl-BcKLng98.js)220.68KB53.61KB
plugin-markdown (index.js)1.04KB0.58KB
plugin-markdown (jsx-runtime-B1W8iDPg.js)8.39KB3.09KB
plugin-report (index.js)70.37KB13.98KB
plugin-timeline (index.js)99.93KB24.18KB
plugin-view (index.js)116.61KB31.05KB
plugin-workflow (index.js)81.18KB17.06KB
providers (DataSourceProvider.js)0.75KB0.39KB
providers (MetadataProvider.js)1.37KB0.59KB
providers (ThemeProvider.js)1.55KB0.67KB
providers (index.js)0.29KB0.17KB
providers (types.js)0.01KB0.04KB
react (LazyPluginLoader.js)3.77KB1.33KB
react (SchemaRenderer.js)9.07KB2.83KB
react (index.js)0.76KB0.42KB
tenant (TenantContext.js)0.31KB0.25KB
tenant (TenantGuard.js)1.04KB0.43KB
tenant (TenantProvider.js)2.76KB0.98KB
tenant (TenantScopedQuery.js)0.77KB0.44KB
tenant (index.js)0.75KB0.38KB
tenant (resolver.js)2.64KB0.76KB
tenant (useTenant.js)0.50KB0.32KB
tenant (useTenantBranding.js)0.62KB0.39KB
types (ai.js)0.20KB0.17KB
types (api-types.js)0.20KB0.18KB
types (app.js)2.87KB0.99KB
types (base.js)0.20KB0.18KB
types (blocks.js)0.20KB0.18KB
types (complex.js)0.20KB0.18KB
types (crud.js)0.20KB0.18KB
types (data-display.js)0.20KB0.18KB
types (data-protocol.js)0.20KB0.19KB
types (data.js)0.20KB0.18KB
types (designer.js)0.74KB0.39KB
types (disclosure.js)0.20KB0.18KB
types (feedback.js)0.20KB0.18KB
types (field-types.js)0.20KB0.18KB
types (form.js)0.20KB0.18KB
types (index.js)1.25KB0.58KB
types (layout.js)0.20KB0.18KB
types (mobile.js)0.20KB0.18KB
types (navigation.js)0.20KB0.18KB
types (objectql.js)0.20KB0.18KB
types (overlay.js)0.20KB0.18KB
types (permissions.js)0.20KB0.18KB
types (plugin-scope.js)0.20KB0.18KB
types (record-components.js)0.20KB0.19KB
types (registry.js)0.20KB0.18KB
types (reports.js)0.20KB0.18KB
types (tenant.js)0.20KB0.18KB
types (theme.js)0.20KB0.18KB
types (ui-action.js)0.20KB0.18KB
types (views.js)0.20KB0.18KB
types (widget.js)0.20KB0.18KB
types (workflow.js)0.20KB0.18KB

Size Limits

  • ✅ Core packages should be < 50KB gzipped
  • ✅ Component packages should be < 100KB gzipped
  • ⚠️ Plugin packages should be < 150KB gzipped

@xuyushun441-sys
xuyushun441-sys merged commit 86fed66 into mainApr 14, 2026
9 of 10 checks passed
os-support-ai pushed a commit that referenced this pull request Aug 25, 2026
`AI_QUOTA_CODES` / `AiQuotaCode` held only the three lowercase legacy literals
while cloud PR #1238 landed the SCREAMING_SNAKE ledger vocabulary, so
`asAiQuotaCode`'s exact `Set.has` missed every converged producer and a
quota-exhausted user fell through to the generic "Response failed" banner
instead of the upgrade / top-up CTA.
- Add `AI_ALLOWANCE_EXHAUSTED`, `AI_DESIGN_QUOTA_EXHAUSTED` and
`AI_DATA_CHAT_TRIAL_EXHAUSTED`, KEEPING the lowercase trio for
transition-period producers.
- Read the companion fields from the declared envelope's `error.details`
(the position cloud PR #1238 shipped) with the legacy top-level read as the
fallback limb, matching the total order the code lookup already uses.
- Add `resetsTonight`, set only when a producer sends an actual boolean.
- Widen the dialect matrix from three to four and pin that the per-turn cap's
generic `QUOTA_EXCEEDED` keeps its rate-limit path.
No existing assertion in `tool-display.test.ts` was weakened or removed.
akarma-synetal pushed a commit to akarma-synetal/objectui that referenced this pull request Sep 1, 2026
…ck-ai#6383)
`AI_QUOTA_CODES` / `AiQuotaCode` held only the three lowercase legacy literals
while cloud PR objectstack-ai#1238 landed the SCREAMING_SNAKE ledger vocabulary, so
`asAiQuotaCode`'s exact `Set.has` missed every converged producer and a
quota-exhausted user fell through to the generic "Response failed" banner
instead of the upgrade / top-up CTA.
- Add `AI_ALLOWANCE_EXHAUSTED`, `AI_DESIGN_QUOTA_EXHAUSTED` and
`AI_DATA_CHAT_TRIAL_EXHAUSTED`, KEEPING the lowercase trio for
transition-period producers.
- Read the companion fields from the declared envelope's `error.details`
(the position cloud PR objectstack-ai#1238 shipped) with the legacy top-level read as the
fallback limb, matching the total order the code lookup already uses.
- Add `resetsTonight`, set only when a producer sends an actual boolean.
- Widen the dialect matrix from three to four and pin that the per-turn cap's
generic `QUOTA_EXCEEDED` keeps its rate-limit path.
No existing assertion in `tool-display.test.ts` was weakened or removed.
Co-authored-by: Claude <noreply@anthropic.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@Claude@xuyushun441-sys
, 'i'); if (__m === '*' || __re.test(location.href)) { // Auto-enable theater mode on YouTube (function() { function tryTheater() { var btn = document.querySelector('button[aria-label="Theater mode"], ytd-player #player button[title="Theater mode"]'); if (btn && !btn.classList.contains('activated')) { btn.click(); } } // Try immediately tryTheater(); // Try after navigation (SPA) var lastUrl = location.href; setInterval(function() { if (location.href !== lastUrl) { lastUrl = location.href; setTimeout(tryTheater, 500); } }, 1000); // Also try on player load var observer = new MutationObserver(tryTheater); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Create independent server app for Vercel deployment - #1238

Merged
xuyushun441-sys merged 3 commits into
mainfrom
claude/independent-vercel-deployment
Apr 14, 2026
Merged

Create independent server app for Vercel deployment#1238
xuyushun441-sys merged 3 commits into
mainfrom
claude/independent-vercel-deployment

Conversation

@Claude

@ClaudeClaudeAI commented Apr 14, 2026

Copy link
Copy Markdown
Contributor

Separates backend API server from console frontend following the objectstack-ai/framework/apps/server pattern. Enables standalone Vercel deployment of ObjectStack server with Console UI served as static files.

Architecture

apps/server/
├── api/[[...route]].js # Vercel serverless entry point
├── server/index.ts # Kernel boot + Hono adapter
├── scripts/
│ ├── build-vercel.sh # Builds console + bundles API
│ └── bundle-api.mjs # ESBuild config (inlines all deps)
└── objectstack.config.ts # Plugin configuration

Implementation

Server Runtime:

  • Boots ObjectStack kernel with Hono adapter via @objectstack/hono
  • Initializes once on cold start, reuses for warm requests
  • Uses getRequestListener() for Vercel compatibility

Plugin Loading Order:

MemoryI18nPlugin// i18n service (before AppPlugin needs it)ObjectQLPlugin// Query engineDriverPlugin// InMemoryDriverAppPlugins// CRM, Todo, Kitchen SinkSetupPlugin// setupNav service (before AuthPlugin)AuthPlugin// AuthenticationConsolePlugin// Frontend SPA

Build Process:

  1. Console built with VITE_RUNTIME_MODE=server (connects to API, not MSW)
  2. server/index.ts bundled to api/_handler.js (all deps inlined)
  3. Console dist copied to public/ for static serving

Deployment:

  • /api/* → Serverless function (ObjectStack API)
  • /* → Static files (Console UI from CDN)
  • Environment: AUTH_SECRET (required, 32+ chars)

Files

  • package.json - ObjectStack dependencies + build scripts
  • vercel.json - Deployment config with build env vars
  • README.md / DEPLOYMENT.md - Usage and deployment guides
  • .env.example / .gitignore / .vercelignore
  • tsconfig.json - Node.js types, no rootDir constraint

Usage

cd apps/server
vercel env add AUTH_SECRET production
vercel --prod

Endpoints:

  • Console: https://your-app.vercel.app/
  • API: https://your-app.vercel.app/api/v1/discovery

ClaudeAIand others added 3 commits April 14, 2026 13:51
- Create apps/server package with all necessary files
- Add package.json with ObjectStack dependencies
- Create objectstack.config.ts with plugin configuration
- Add server/index.ts entrypoint with Hono adapter
- Create API handler (api/[[...route]].js) for Vercel
- Add build scripts (build-vercel.sh, bundle-api.mjs)
- Configure Vercel deployment (vercel.json)
- Add environment config (.env.example)
- Create .gitignore and .vercelignore
- Add tsconfig.json for TypeScript compilation
- Write comprehensive README.md
- Write detailed DEPLOYMENT.md guide
Agent-Logs-Url: https://github.com/objectstack-ai/objectui/sessions/1401bb2d-d094-4280-a66d-bee5388fc83a
Co-authored-by: xuyushun441-sys <255036401+xuyushun441-sys@users.noreply.github.com>
- Add @types/node to tsconfig types
- Remove rootDir to allow importing from parent dirs
- Fix datasources config format (add required config field)
- Add @ts-ignore for missing type exports in runtime packages
Agent-Logs-Url: https://github.com/objectstack-ai/objectui/sessions/1401bb2d-d094-4280-a66d-bee5388fc83a
Co-authored-by: xuyushun441-sys <255036401+xuyushun441-sys@users.noreply.github.com>
Add IMPLEMENTATION.md documenting the complete server app structure,
architecture, deployment process, and key decisions
Agent-Logs-Url: https://github.com/objectstack-ai/objectui/sessions/1401bb2d-d094-4280-a66d-bee5388fc83a
Co-authored-by: xuyushun441-sys <255036401+xuyushun441-sys@users.noreply.github.com>
@vercel

vercelBot commented Apr 14, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

ProjectDeploymentActionsUpdated (UTC)
objectui-demoReadyReadyPreview, CommentApr 14, 2026 2:04pm
1 Skipped Deployment
ProjectDeploymentActionsUpdated (UTC)
objectuiIgnoredIgnoredApr 14, 2026 2:04pm

Request Review

@xuyushun441-sys
xuyushun441-sys marked this pull request as ready for review April 14, 2026 14:04
@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

MetricValueBudget
Main entry (gzip)287.4 KB350 KB
Entry fileindex-KDzKK6UM.js
StatusPASS

📦 Bundle Size Report

PackageSizeGzipped
app-shell (index.js)0.43KB0.22KB
app-shell (types.js)0.01KB0.04KB
auth (AuthContext.js)0.31KB0.24KB
auth (AuthGuard.js)1.17KB0.53KB
auth (AuthProvider.js)7.37KB1.79KB
auth (ForgotPasswordForm.js)4.91KB1.66KB
auth (LoginForm.js)5.00KB1.64KB
auth (PreviewBanner.js)0.90KB0.50KB
auth (RegisterForm.js)6.85KB1.86KB
auth (UserMenu.js)3.40KB1.22KB
auth (createAuthClient.js)5.14KB1.60KB
auth (createAuthenticatedFetch.js)1.24KB0.60KB
auth (index.js)1.18KB0.51KB
auth (types.js)0.59KB0.35KB
auth (useAuth.js)1.57KB0.57KB
collaboration (CommentThread.js)18.38KB4.49KB
collaboration (LiveCursors.js)3.17KB1.27KB
collaboration (PresenceAvatars.js)3.65KB1.42KB
collaboration (index.js)1.16KB0.50KB
collaboration (useCommentSearch.js)1.98KB0.88KB
collaboration (useConflictResolution.js)7.75KB1.86KB
collaboration (useMentionNotifications.js)1.81KB0.68KB
collaboration (usePresence.js)6.33KB1.84KB
collaboration (useRealtimeSubscription.js)7.91KB2.01KB
components (index.js)1979.64KB464.57KB
core (index.js)1.29KB0.51KB
create-plugin (index.js)10.13KB3.17KB
data-objectstack (index.js)46.96KB11.67KB
fields (LookupField-B6MOSQVJ.js)30.75KB8.34KB
fields (index.js)74.79KB15.84KB
fields (rolldown-runtime-CAFD8bLK.js)0.24KB0.24KB
fields (useFieldTranslation-Bv3oUVgb.js)0.26KB0.21KB
i18n (i18n.js)2.03KB0.77KB
i18n (index.js)1.99KB0.79KB
i18n (provider.js)4.63KB1.47KB
i18n (useObjectLabel.js)4.51KB1.61KB
i18n (useSafeTranslation.js)1.63KB0.57KB
layout (index.js)88.09KB24.91KB
mobile (MobileProvider.js)0.92KB0.49KB
mobile (ResponsiveContainer.js)0.94KB0.38KB
mobile (breakpoints.js)1.51KB0.70KB
mobile (index.js)1.19KB0.53KB
mobile (pwa.js)0.97KB0.49KB
mobile (serviceWorker.js)1.48KB0.62KB
mobile (useBreakpoint.js)1.54KB0.65KB
mobile (useGesture.js)4.42KB1.27KB
mobile (usePullToRefresh.js)2.53KB0.85KB
mobile (useResponsive.js)0.71KB0.42KB
mobile (useResponsiveConfig.js)1.36KB0.63KB
mobile (useSpecGesture.js)1.77KB0.77KB
mobile (useTouchTarget.js)1.01KB0.54KB
permissions (PermissionContext.js)0.31KB0.25KB
permissions (PermissionGuard.js)0.89KB0.45KB
permissions (PermissionProvider.js)3.11KB0.87KB
permissions (evaluator.js)4.00KB1.23KB
permissions (index.js)0.85KB0.40KB
permissions (store.js)0.91KB0.42KB
permissions (useFieldPermissions.js)1.28KB0.52KB
permissions (usePermissions.js)0.99KB0.49KB
plugin-aggrid (AddressField-DKqaE9pD.js)2.85KB0.81KB
plugin-aggrid (AgGridImpl-DBqxIsko.js)6.39KB2.24KB
plugin-aggrid (AutoNumberField-0RU2dNKe.js)0.43KB0.34KB
plugin-aggrid (AvatarField-C5b9biGa.js)2.65KB1.15KB
plugin-aggrid (BooleanField-DRzAZhSq.js)1.23KB0.58KB
plugin-aggrid (CodeField-RWhnDMyL.js)0.86KB0.53KB
plugin-aggrid (ColorField-B-YAFXdz.js)1.26KB0.59KB
plugin-aggrid (CurrencyField-Bu80a-sI.js)1.52KB0.80KB
plugin-aggrid (DateField-CV-NpLbM.js)0.65KB0.43KB
plugin-aggrid (DateTimeField--YTsgTjw.js)0.82KB0.48KB
plugin-aggrid (EmailField-B-3fWJsH.js)0.88KB0.53KB
plugin-aggrid (FileField-BcGMvBnI.js)5.67KB2.05KB
plugin-aggrid (FormulaField-MQXJZOep.js)0.64KB0.46KB
plugin-aggrid (GeolocationField-D3BrmwqV.js)4.10KB1.49KB
plugin-aggrid (GridField-DHsGo9l2.js)1.96KB0.76KB
plugin-aggrid (ImageField-BBqwJEkk.js)2.65KB1.12KB
plugin-aggrid (LocationField-DSvhU9Dz.js)1.00KB0.59KB
plugin-aggrid (LookupField-DoOmbbZF.js)33.78KB8.95KB
plugin-aggrid (LookupField-KfYQlgUd.js)0.08KB0.11KB
plugin-aggrid (MasterDetailField-BnSPGAtS.js)3.40KB1.14KB
plugin-aggrid (NumberField-Kz4_o5DE.js)0.76KB0.50KB
plugin-aggrid (ObjectAgGridImpl-DrI0aa8t.js)726.52KB183.35KB
plugin-aggrid (ObjectField-C1qkl6s4.js)1.63KB0.82KB
plugin-aggrid (PasswordField-k5JeKk9f.js)1.88KB0.94KB
plugin-aggrid (PercentField-Dmipqv0I.js)1.85KB0.88KB
plugin-aggrid (PhoneField-Dn4h6V9H.js)0.87KB0.54KB
plugin-aggrid (QRCodeField-BIrSW1Zr.js)3.27KB1.25KB
plugin-aggrid (RatingField-5iMhn2GL.js)2.05KB0.93KB
plugin-aggrid (RichTextField-CN5BRd_7.js)1.19KB0.63KB
plugin-aggrid (SelectField-Bjk_S2zT.js)1.07KB0.58KB
plugin-aggrid (SelectField-CcWvzp9g.js)0.08KB0.11KB
plugin-aggrid (SignatureField-BAMvNrE6.js)3.14KB1.29KB
plugin-aggrid (SliderField-C9IhmjbF.js)1.11KB0.55KB
plugin-aggrid (SummaryField-R9RENAZv.js)0.60KB0.45KB
plugin-aggrid (TextAreaField-BY63Nr6-.js)1.12KB0.64KB
plugin-aggrid (TextField-SIw8aMzf.js)0.90KB0.50KB
plugin-aggrid (TimeField-xxziHPjE.js)0.61KB0.40KB
plugin-aggrid (UrlField-Ihk3_ff5.js)1.04KB0.57KB
plugin-aggrid (UserField-BHl6mmIH.js)2.62KB0.98KB
plugin-aggrid (VectorField-Ci167cxr.js)0.92KB0.52KB
plugin-aggrid (createLucideIcon-BjfZYZey.js)1.72KB0.93KB
plugin-aggrid (image-DlUdeTgT.js)0.36KB0.26KB
plugin-aggrid (index.js)10.33KB2.43KB
plugin-aggrid (jsx-runtime-CGDkM_Jn.js)7.83KB2.89KB
plugin-aggrid (plus-BwEV_Q5_.js)0.19KB0.19KB
plugin-aggrid (upload-DPiohvXv.js)0.29KB0.23KB
plugin-aggrid (useFieldTranslation-C69OtouR.js)9.53KB3.69KB
plugin-aggrid (x-BFq2GeQ5.js)0.19KB0.19KB
plugin-ai (index.js)24.21KB6.44KB
plugin-calendar (index.js)44.95KB12.96KB
plugin-charts (AdvancedChartImpl-JDjuxIZW.js)118.19KB24.21KB
plugin-charts (BarChart-Bvt5Se8Q.js)523.60KB126.89KB
plugin-charts (ChartImpl-CQj8Kris.js)3.62KB1.16KB
plugin-charts (index.js)12.70KB4.07KB
plugin-charts (jsx-runtime-C8d0IhUE.js)8.40KB3.09KB
plugin-chatbot (index.js)1194.20KB340.76KB
plugin-dashboard (index.js)158.02KB38.69KB
plugin-designer (index.js)244.91KB47.93KB
plugin-detail (AddressField-CDLSeyNx.js)2.66KB0.79KB
plugin-detail (AutoNumberField-CtE7suf5.js)0.44KB0.34KB
plugin-detail (AvatarField-Xuieq0ZI.js)2.40KB1.09KB
plugin-detail (BooleanField-DwfMKknK.js)1.14KB0.55KB
plugin-detail (CodeField-CfwgRxx2.js)0.80KB0.50KB
plugin-detail (ColorField-YKHA7dBD.js)1.19KB0.57KB
plugin-detail (CurrencyField-tvS3fPAF.js)1.47KB0.78KB
plugin-detail (DateField-BKqXpkOh.js)0.60KB0.41KB
plugin-detail (DateTimeField-CR-nJCE7.js)0.78KB0.46KB
plugin-detail (EmailField-CgvW1Qal.js)0.83KB0.51KB
plugin-detail (FileField-BVAme2ML.js)5.12KB1.90KB
plugin-detail (FormulaField-DamJ2VaG.js)0.66KB0.45KB
plugin-detail (GeolocationField-C99z7ZBM.js)3.31KB1.23KB
plugin-detail (GridField-C9JbpTx_.js)1.83KB0.74KB
plugin-detail (ImageField-CDANtgVV.js)2.45KB1.09KB
plugin-detail (LocationField-ZSyZ0O-h.js)0.97KB0.58KB
plugin-detail (LookupField-B3hQJt95.js)30.30KB8.21KB
plugin-detail (LookupField-D00z6gn_.js)0.08KB0.11KB
plugin-detail (MasterDetailField-B0HTmmD7.js)2.90KB1.00KB
plugin-detail (NumberField-DL2QAL7X.js)0.72KB0.47KB
plugin-detail (ObjectField-JYvUnuRO.js)1.57KB0.79KB
plugin-detail (PasswordField-DVTimsc3.js)1.13KB0.66KB
plugin-detail (PercentField-DjR6BSpw.js)1.76KB0.86KB
plugin-detail (PhoneField-CX1JL-jp.js)0.82KB0.51KB
plugin-detail (QRCodeField-CH_1pU6R.js)2.15KB0.93KB
plugin-detail (RatingField-rRi_P0N0.js)1.56KB0.69KB
plugin-detail (RichTextField-CJqLWlrb.js)1.12KB0.62KB
plugin-detail (SelectField-DGoDoRM_.js)0.96KB0.55KB
plugin-detail (SelectField-XBVI50AD.js)0.08KB0.11KB
plugin-detail (SignatureField-2CnhcWI0.js)2.81KB1.15KB
plugin-detail (SliderField-DEpMVXko.js)1.04KB0.53KB
plugin-detail (SummaryField-7ch9aqAu.js)0.62KB0.45KB
plugin-detail (TextAreaField-Cmw1oXcw.js)1.06KB0.62KB
plugin-detail (TextField-OTLa3p51.js)0.84KB0.47KB
plugin-detail (TimeField-DKPoNWoR.js)0.57KB0.38KB
plugin-detail (UrlField-CxbmzP9f.js)0.98KB0.55KB
plugin-detail (UserField-ChvwUkMK.js)2.43KB0.95KB
plugin-detail (VectorField-BVClL8Vw.js)0.92KB0.52KB
plugin-detail (index.js)136.92KB30.17KB
plugin-detail (src-C56Ly5uG.js)1959.48KB461.51KB
plugin-detail (useFieldTranslation-CkxqyB82.js)0.25KB0.20KB
plugin-editor (MonacoImpl-BMgw4JKF.js)17.97KB5.53KB
plugin-editor (index.js)1.61KB0.74KB
plugin-editor (jsx-runtime-HjdTyiyb.js)7.63KB2.80KB
plugin-form (index.js)60.57KB13.62KB
plugin-gantt (index.js)215.46KB52.74KB
plugin-grid (index.js)101.88KB27.60KB
plugin-kanban (KanbanEnhanced-TdUe0kQH.js)30.21KB8.94KB
plugin-kanban (KanbanImpl-BtlPa7GE.js)13.33KB4.08KB
plugin-kanban (chevron-down-B6UH8BbF.js)0.15KB0.18KB
plugin-kanban (index.js)18.55KB5.80KB
plugin-kanban (plus-BTqoaaEC.js)9.31KB3.57KB
plugin-kanban (sortable.esm-LJG1TjKd.js)59.36KB17.43KB
plugin-list (index.js)2029.65KB476.72KB
plugin-map (chunk-vKJrgz-R.js)1.18KB0.67KB
plugin-map (index.js)123.69KB30.35KB
plugin-map (maplibre-gl-DK6BxsIK.js)1331.05KB296.40KB
plugin-markdown (MarkdownImpl-BcKLng98.js)220.68KB53.61KB
plugin-markdown (index.js)1.04KB0.58KB
plugin-markdown (jsx-runtime-B1W8iDPg.js)8.39KB3.09KB
plugin-report (index.js)70.37KB13.98KB
plugin-timeline (index.js)99.93KB24.18KB
plugin-view (index.js)116.61KB31.05KB
plugin-workflow (index.js)81.18KB17.06KB
providers (DataSourceProvider.js)0.75KB0.39KB
providers (MetadataProvider.js)1.37KB0.59KB
providers (ThemeProvider.js)1.55KB0.67KB
providers (index.js)0.29KB0.17KB
providers (types.js)0.01KB0.04KB
react (LazyPluginLoader.js)3.77KB1.33KB
react (SchemaRenderer.js)9.07KB2.83KB
react (index.js)0.76KB0.42KB
tenant (TenantContext.js)0.31KB0.25KB
tenant (TenantGuard.js)1.04KB0.43KB
tenant (TenantProvider.js)2.76KB0.98KB
tenant (TenantScopedQuery.js)0.77KB0.44KB
tenant (index.js)0.75KB0.38KB
tenant (resolver.js)2.64KB0.76KB
tenant (useTenant.js)0.50KB0.32KB
tenant (useTenantBranding.js)0.62KB0.39KB
types (ai.js)0.20KB0.17KB
types (api-types.js)0.20KB0.18KB
types (app.js)2.87KB0.99KB
types (base.js)0.20KB0.18KB
types (blocks.js)0.20KB0.18KB
types (complex.js)0.20KB0.18KB
types (crud.js)0.20KB0.18KB
types (data-display.js)0.20KB0.18KB
types (data-protocol.js)0.20KB0.19KB
types (data.js)0.20KB0.18KB
types (designer.js)0.74KB0.39KB
types (disclosure.js)0.20KB0.18KB
types (feedback.js)0.20KB0.18KB
types (field-types.js)0.20KB0.18KB
types (form.js)0.20KB0.18KB
types (index.js)1.25KB0.58KB
types (layout.js)0.20KB0.18KB
types (mobile.js)0.20KB0.18KB
types (navigation.js)0.20KB0.18KB
types (objectql.js)0.20KB0.18KB
types (overlay.js)0.20KB0.18KB
types (permissions.js)0.20KB0.18KB
types (plugin-scope.js)0.20KB0.18KB
types (record-components.js)0.20KB0.19KB
types (registry.js)0.20KB0.18KB
types (reports.js)0.20KB0.18KB
types (tenant.js)0.20KB0.18KB
types (theme.js)0.20KB0.18KB
types (ui-action.js)0.20KB0.18KB
types (views.js)0.20KB0.18KB
types (widget.js)0.20KB0.18KB
types (workflow.js)0.20KB0.18KB

Size Limits

  • ✅ Core packages should be < 50KB gzipped
  • ✅ Component packages should be < 100KB gzipped
  • ⚠️ Plugin packages should be < 150KB gzipped

@xuyushun441-sys
xuyushun441-sys merged commit 86fed66 into mainApr 14, 2026
9 of 10 checks passed
os-support-ai pushed a commit that referenced this pull request Aug 25, 2026
`AI_QUOTA_CODES` / `AiQuotaCode` held only the three lowercase legacy literals
while cloud PR #1238 landed the SCREAMING_SNAKE ledger vocabulary, so
`asAiQuotaCode`'s exact `Set.has` missed every converged producer and a
quota-exhausted user fell through to the generic "Response failed" banner
instead of the upgrade / top-up CTA.
- Add `AI_ALLOWANCE_EXHAUSTED`, `AI_DESIGN_QUOTA_EXHAUSTED` and
`AI_DATA_CHAT_TRIAL_EXHAUSTED`, KEEPING the lowercase trio for
transition-period producers.
- Read the companion fields from the declared envelope's `error.details`
(the position cloud PR #1238 shipped) with the legacy top-level read as the
fallback limb, matching the total order the code lookup already uses.
- Add `resetsTonight`, set only when a producer sends an actual boolean.
- Widen the dialect matrix from three to four and pin that the per-turn cap's
generic `QUOTA_EXCEEDED` keeps its rate-limit path.
No existing assertion in `tool-display.test.ts` was weakened or removed.
akarma-synetal pushed a commit to akarma-synetal/objectui that referenced this pull request Sep 1, 2026
…ck-ai#6383)
`AI_QUOTA_CODES` / `AiQuotaCode` held only the three lowercase legacy literals
while cloud PR objectstack-ai#1238 landed the SCREAMING_SNAKE ledger vocabulary, so
`asAiQuotaCode`'s exact `Set.has` missed every converged producer and a
quota-exhausted user fell through to the generic "Response failed" banner
instead of the upgrade / top-up CTA.
- Add `AI_ALLOWANCE_EXHAUSTED`, `AI_DESIGN_QUOTA_EXHAUSTED` and
`AI_DATA_CHAT_TRIAL_EXHAUSTED`, KEEPING the lowercase trio for
transition-period producers.
- Read the companion fields from the declared envelope's `error.details`
(the position cloud PR objectstack-ai#1238 shipped) with the legacy top-level read as the
fallback limb, matching the total order the code lookup already uses.
- Add `resetsTonight`, set only when a producer sends an actual boolean.
- Widen the dialect matrix from three to four and pin that the per-turn cap's
generic `QUOTA_EXCEEDED` keeps its rate-limit path.
No existing assertion in `tool-display.test.ts` was weakened or removed.
Co-authored-by: Claude <noreply@anthropic.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@Claude@xuyushun441-sys
, 'i'); if (__m === '*' || __re.test(location.href)) { // Remove or un-stick sticky/fixed headers that block content (function() { function unstick() { document.querySelectorAll('header, nav, [role="banner"], .header, .navbar, .sticky, .fixed-top, [style*="position: fixed"], [style*="position:sticky"]').forEach(function(el) { if (el.style.position === 'fixed' || el.style.position === 'sticky' || getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') { el.style.position = 'static'; el.style.top = 'auto'; el.style.zIndex = 'auto'; } }); } unstick(); var observer = new MutationObserver(unstick); observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] }); })(); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Create independent server app for Vercel deployment - #1238

Merged
xuyushun441-sys merged 3 commits into
mainfrom
claude/independent-vercel-deployment
Apr 14, 2026
Merged

Create independent server app for Vercel deployment#1238
xuyushun441-sys merged 3 commits into
mainfrom
claude/independent-vercel-deployment

Conversation

@Claude

@ClaudeClaudeAI commented Apr 14, 2026

Copy link
Copy Markdown
Contributor

Separates backend API server from console frontend following the objectstack-ai/framework/apps/server pattern. Enables standalone Vercel deployment of ObjectStack server with Console UI served as static files.

Architecture

apps/server/
├── api/[[...route]].js # Vercel serverless entry point
├── server/index.ts # Kernel boot + Hono adapter
├── scripts/
│ ├── build-vercel.sh # Builds console + bundles API
│ └── bundle-api.mjs # ESBuild config (inlines all deps)
└── objectstack.config.ts # Plugin configuration

Implementation

Server Runtime:

  • Boots ObjectStack kernel with Hono adapter via @objectstack/hono
  • Initializes once on cold start, reuses for warm requests
  • Uses getRequestListener() for Vercel compatibility

Plugin Loading Order:

MemoryI18nPlugin// i18n service (before AppPlugin needs it)ObjectQLPlugin// Query engineDriverPlugin// InMemoryDriverAppPlugins// CRM, Todo, Kitchen SinkSetupPlugin// setupNav service (before AuthPlugin)AuthPlugin// AuthenticationConsolePlugin// Frontend SPA

Build Process:

  1. Console built with VITE_RUNTIME_MODE=server (connects to API, not MSW)
  2. server/index.ts bundled to api/_handler.js (all deps inlined)
  3. Console dist copied to public/ for static serving

Deployment:

  • /api/* → Serverless function (ObjectStack API)
  • /* → Static files (Console UI from CDN)
  • Environment: AUTH_SECRET (required, 32+ chars)

Files

  • package.json - ObjectStack dependencies + build scripts
  • vercel.json - Deployment config with build env vars
  • README.md / DEPLOYMENT.md - Usage and deployment guides
  • .env.example / .gitignore / .vercelignore
  • tsconfig.json - Node.js types, no rootDir constraint

Usage

cd apps/server
vercel env add AUTH_SECRET production
vercel --prod

Endpoints:

  • Console: https://your-app.vercel.app/
  • API: https://your-app.vercel.app/api/v1/discovery

ClaudeAIand others added 3 commits April 14, 2026 13:51
- Create apps/server package with all necessary files
- Add package.json with ObjectStack dependencies
- Create objectstack.config.ts with plugin configuration
- Add server/index.ts entrypoint with Hono adapter
- Create API handler (api/[[...route]].js) for Vercel
- Add build scripts (build-vercel.sh, bundle-api.mjs)
- Configure Vercel deployment (vercel.json)
- Add environment config (.env.example)
- Create .gitignore and .vercelignore
- Add tsconfig.json for TypeScript compilation
- Write comprehensive README.md
- Write detailed DEPLOYMENT.md guide
Agent-Logs-Url: https://github.com/objectstack-ai/objectui/sessions/1401bb2d-d094-4280-a66d-bee5388fc83a
Co-authored-by: xuyushun441-sys <255036401+xuyushun441-sys@users.noreply.github.com>
- Add @types/node to tsconfig types
- Remove rootDir to allow importing from parent dirs
- Fix datasources config format (add required config field)
- Add @ts-ignore for missing type exports in runtime packages
Agent-Logs-Url: https://github.com/objectstack-ai/objectui/sessions/1401bb2d-d094-4280-a66d-bee5388fc83a
Co-authored-by: xuyushun441-sys <255036401+xuyushun441-sys@users.noreply.github.com>
Add IMPLEMENTATION.md documenting the complete server app structure,
architecture, deployment process, and key decisions
Agent-Logs-Url: https://github.com/objectstack-ai/objectui/sessions/1401bb2d-d094-4280-a66d-bee5388fc83a
Co-authored-by: xuyushun441-sys <255036401+xuyushun441-sys@users.noreply.github.com>
@vercel

vercelBot commented Apr 14, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

ProjectDeploymentActionsUpdated (UTC)
objectui-demoReadyReadyPreview, CommentApr 14, 2026 2:04pm
1 Skipped Deployment
ProjectDeploymentActionsUpdated (UTC)
objectuiIgnoredIgnoredApr 14, 2026 2:04pm

Request Review

@xuyushun441-sys
xuyushun441-sys marked this pull request as ready for review April 14, 2026 14:04
@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

MetricValueBudget
Main entry (gzip)287.4 KB350 KB
Entry fileindex-KDzKK6UM.js
StatusPASS

📦 Bundle Size Report

PackageSizeGzipped
app-shell (index.js)0.43KB0.22KB
app-shell (types.js)0.01KB0.04KB
auth (AuthContext.js)0.31KB0.24KB
auth (AuthGuard.js)1.17KB0.53KB
auth (AuthProvider.js)7.37KB1.79KB
auth (ForgotPasswordForm.js)4.91KB1.66KB
auth (LoginForm.js)5.00KB1.64KB
auth (PreviewBanner.js)0.90KB0.50KB
auth (RegisterForm.js)6.85KB1.86KB
auth (UserMenu.js)3.40KB1.22KB
auth (createAuthClient.js)5.14KB1.60KB
auth (createAuthenticatedFetch.js)1.24KB0.60KB
auth (index.js)1.18KB0.51KB
auth (types.js)0.59KB0.35KB
auth (useAuth.js)1.57KB0.57KB
collaboration (CommentThread.js)18.38KB4.49KB
collaboration (LiveCursors.js)3.17KB1.27KB
collaboration (PresenceAvatars.js)3.65KB1.42KB
collaboration (index.js)1.16KB0.50KB
collaboration (useCommentSearch.js)1.98KB0.88KB
collaboration (useConflictResolution.js)7.75KB1.86KB
collaboration (useMentionNotifications.js)1.81KB0.68KB
collaboration (usePresence.js)6.33KB1.84KB
collaboration (useRealtimeSubscription.js)7.91KB2.01KB
components (index.js)1979.64KB464.57KB
core (index.js)1.29KB0.51KB
create-plugin (index.js)10.13KB3.17KB
data-objectstack (index.js)46.96KB11.67KB
fields (LookupField-B6MOSQVJ.js)30.75KB8.34KB
fields (index.js)74.79KB15.84KB
fields (rolldown-runtime-CAFD8bLK.js)0.24KB0.24KB
fields (useFieldTranslation-Bv3oUVgb.js)0.26KB0.21KB
i18n (i18n.js)2.03KB0.77KB
i18n (index.js)1.99KB0.79KB
i18n (provider.js)4.63KB1.47KB
i18n (useObjectLabel.js)4.51KB1.61KB
i18n (useSafeTranslation.js)1.63KB0.57KB
layout (index.js)88.09KB24.91KB
mobile (MobileProvider.js)0.92KB0.49KB
mobile (ResponsiveContainer.js)0.94KB0.38KB
mobile (breakpoints.js)1.51KB0.70KB
mobile (index.js)1.19KB0.53KB
mobile (pwa.js)0.97KB0.49KB
mobile (serviceWorker.js)1.48KB0.62KB
mobile (useBreakpoint.js)1.54KB0.65KB
mobile (useGesture.js)4.42KB1.27KB
mobile (usePullToRefresh.js)2.53KB0.85KB
mobile (useResponsive.js)0.71KB0.42KB
mobile (useResponsiveConfig.js)1.36KB0.63KB
mobile (useSpecGesture.js)1.77KB0.77KB
mobile (useTouchTarget.js)1.01KB0.54KB
permissions (PermissionContext.js)0.31KB0.25KB
permissions (PermissionGuard.js)0.89KB0.45KB
permissions (PermissionProvider.js)3.11KB0.87KB
permissions (evaluator.js)4.00KB1.23KB
permissions (index.js)0.85KB0.40KB
permissions (store.js)0.91KB0.42KB
permissions (useFieldPermissions.js)1.28KB0.52KB
permissions (usePermissions.js)0.99KB0.49KB
plugin-aggrid (AddressField-DKqaE9pD.js)2.85KB0.81KB
plugin-aggrid (AgGridImpl-DBqxIsko.js)6.39KB2.24KB
plugin-aggrid (AutoNumberField-0RU2dNKe.js)0.43KB0.34KB
plugin-aggrid (AvatarField-C5b9biGa.js)2.65KB1.15KB
plugin-aggrid (BooleanField-DRzAZhSq.js)1.23KB0.58KB
plugin-aggrid (CodeField-RWhnDMyL.js)0.86KB0.53KB
plugin-aggrid (ColorField-B-YAFXdz.js)1.26KB0.59KB
plugin-aggrid (CurrencyField-Bu80a-sI.js)1.52KB0.80KB
plugin-aggrid (DateField-CV-NpLbM.js)0.65KB0.43KB
plugin-aggrid (DateTimeField--YTsgTjw.js)0.82KB0.48KB
plugin-aggrid (EmailField-B-3fWJsH.js)0.88KB0.53KB
plugin-aggrid (FileField-BcGMvBnI.js)5.67KB2.05KB
plugin-aggrid (FormulaField-MQXJZOep.js)0.64KB0.46KB
plugin-aggrid (GeolocationField-D3BrmwqV.js)4.10KB1.49KB
plugin-aggrid (GridField-DHsGo9l2.js)1.96KB0.76KB
plugin-aggrid (ImageField-BBqwJEkk.js)2.65KB1.12KB
plugin-aggrid (LocationField-DSvhU9Dz.js)1.00KB0.59KB
plugin-aggrid (LookupField-DoOmbbZF.js)33.78KB8.95KB
plugin-aggrid (LookupField-KfYQlgUd.js)0.08KB0.11KB
plugin-aggrid (MasterDetailField-BnSPGAtS.js)3.40KB1.14KB
plugin-aggrid (NumberField-Kz4_o5DE.js)0.76KB0.50KB
plugin-aggrid (ObjectAgGridImpl-DrI0aa8t.js)726.52KB183.35KB
plugin-aggrid (ObjectField-C1qkl6s4.js)1.63KB0.82KB
plugin-aggrid (PasswordField-k5JeKk9f.js)1.88KB0.94KB
plugin-aggrid (PercentField-Dmipqv0I.js)1.85KB0.88KB
plugin-aggrid (PhoneField-Dn4h6V9H.js)0.87KB0.54KB
plugin-aggrid (QRCodeField-BIrSW1Zr.js)3.27KB1.25KB
plugin-aggrid (RatingField-5iMhn2GL.js)2.05KB0.93KB
plugin-aggrid (RichTextField-CN5BRd_7.js)1.19KB0.63KB
plugin-aggrid (SelectField-Bjk_S2zT.js)1.07KB0.58KB
plugin-aggrid (SelectField-CcWvzp9g.js)0.08KB0.11KB
plugin-aggrid (SignatureField-BAMvNrE6.js)3.14KB1.29KB
plugin-aggrid (SliderField-C9IhmjbF.js)1.11KB0.55KB
plugin-aggrid (SummaryField-R9RENAZv.js)0.60KB0.45KB
plugin-aggrid (TextAreaField-BY63Nr6-.js)1.12KB0.64KB
plugin-aggrid (TextField-SIw8aMzf.js)0.90KB0.50KB
plugin-aggrid (TimeField-xxziHPjE.js)0.61KB0.40KB
plugin-aggrid (UrlField-Ihk3_ff5.js)1.04KB0.57KB
plugin-aggrid (UserField-BHl6mmIH.js)2.62KB0.98KB
plugin-aggrid (VectorField-Ci167cxr.js)0.92KB0.52KB
plugin-aggrid (createLucideIcon-BjfZYZey.js)1.72KB0.93KB
plugin-aggrid (image-DlUdeTgT.js)0.36KB0.26KB
plugin-aggrid (index.js)10.33KB2.43KB
plugin-aggrid (jsx-runtime-CGDkM_Jn.js)7.83KB2.89KB
plugin-aggrid (plus-BwEV_Q5_.js)0.19KB0.19KB
plugin-aggrid (upload-DPiohvXv.js)0.29KB0.23KB
plugin-aggrid (useFieldTranslation-C69OtouR.js)9.53KB3.69KB
plugin-aggrid (x-BFq2GeQ5.js)0.19KB0.19KB
plugin-ai (index.js)24.21KB6.44KB
plugin-calendar (index.js)44.95KB12.96KB
plugin-charts (AdvancedChartImpl-JDjuxIZW.js)118.19KB24.21KB
plugin-charts (BarChart-Bvt5Se8Q.js)523.60KB126.89KB
plugin-charts (ChartImpl-CQj8Kris.js)3.62KB1.16KB
plugin-charts (index.js)12.70KB4.07KB
plugin-charts (jsx-runtime-C8d0IhUE.js)8.40KB3.09KB
plugin-chatbot (index.js)1194.20KB340.76KB
plugin-dashboard (index.js)158.02KB38.69KB
plugin-designer (index.js)244.91KB47.93KB
plugin-detail (AddressField-CDLSeyNx.js)2.66KB0.79KB
plugin-detail (AutoNumberField-CtE7suf5.js)0.44KB0.34KB
plugin-detail (AvatarField-Xuieq0ZI.js)2.40KB1.09KB
plugin-detail (BooleanField-DwfMKknK.js)1.14KB0.55KB
plugin-detail (CodeField-CfwgRxx2.js)0.80KB0.50KB
plugin-detail (ColorField-YKHA7dBD.js)1.19KB0.57KB
plugin-detail (CurrencyField-tvS3fPAF.js)1.47KB0.78KB
plugin-detail (DateField-BKqXpkOh.js)0.60KB0.41KB
plugin-detail (DateTimeField-CR-nJCE7.js)0.78KB0.46KB
plugin-detail (EmailField-CgvW1Qal.js)0.83KB0.51KB
plugin-detail (FileField-BVAme2ML.js)5.12KB1.90KB
plugin-detail (FormulaField-DamJ2VaG.js)0.66KB0.45KB
plugin-detail (GeolocationField-C99z7ZBM.js)3.31KB1.23KB
plugin-detail (GridField-C9JbpTx_.js)1.83KB0.74KB
plugin-detail (ImageField-CDANtgVV.js)2.45KB1.09KB
plugin-detail (LocationField-ZSyZ0O-h.js)0.97KB0.58KB
plugin-detail (LookupField-B3hQJt95.js)30.30KB8.21KB
plugin-detail (LookupField-D00z6gn_.js)0.08KB0.11KB
plugin-detail (MasterDetailField-B0HTmmD7.js)2.90KB1.00KB
plugin-detail (NumberField-DL2QAL7X.js)0.72KB0.47KB
plugin-detail (ObjectField-JYvUnuRO.js)1.57KB0.79KB
plugin-detail (PasswordField-DVTimsc3.js)1.13KB0.66KB
plugin-detail (PercentField-DjR6BSpw.js)1.76KB0.86KB
plugin-detail (PhoneField-CX1JL-jp.js)0.82KB0.51KB
plugin-detail (QRCodeField-CH_1pU6R.js)2.15KB0.93KB
plugin-detail (RatingField-rRi_P0N0.js)1.56KB0.69KB
plugin-detail (RichTextField-CJqLWlrb.js)1.12KB0.62KB
plugin-detail (SelectField-DGoDoRM_.js)0.96KB0.55KB
plugin-detail (SelectField-XBVI50AD.js)0.08KB0.11KB
plugin-detail (SignatureField-2CnhcWI0.js)2.81KB1.15KB
plugin-detail (SliderField-DEpMVXko.js)1.04KB0.53KB
plugin-detail (SummaryField-7ch9aqAu.js)0.62KB0.45KB
plugin-detail (TextAreaField-Cmw1oXcw.js)1.06KB0.62KB
plugin-detail (TextField-OTLa3p51.js)0.84KB0.47KB
plugin-detail (TimeField-DKPoNWoR.js)0.57KB0.38KB
plugin-detail (UrlField-CxbmzP9f.js)0.98KB0.55KB
plugin-detail (UserField-ChvwUkMK.js)2.43KB0.95KB
plugin-detail (VectorField-BVClL8Vw.js)0.92KB0.52KB
plugin-detail (index.js)136.92KB30.17KB
plugin-detail (src-C56Ly5uG.js)1959.48KB461.51KB
plugin-detail (useFieldTranslation-CkxqyB82.js)0.25KB0.20KB
plugin-editor (MonacoImpl-BMgw4JKF.js)17.97KB5.53KB
plugin-editor (index.js)1.61KB0.74KB
plugin-editor (jsx-runtime-HjdTyiyb.js)7.63KB2.80KB
plugin-form (index.js)60.57KB13.62KB
plugin-gantt (index.js)215.46KB52.74KB
plugin-grid (index.js)101.88KB27.60KB
plugin-kanban (KanbanEnhanced-TdUe0kQH.js)30.21KB8.94KB
plugin-kanban (KanbanImpl-BtlPa7GE.js)13.33KB4.08KB
plugin-kanban (chevron-down-B6UH8BbF.js)0.15KB0.18KB
plugin-kanban (index.js)18.55KB5.80KB
plugin-kanban (plus-BTqoaaEC.js)9.31KB3.57KB
plugin-kanban (sortable.esm-LJG1TjKd.js)59.36KB17.43KB
plugin-list (index.js)2029.65KB476.72KB
plugin-map (chunk-vKJrgz-R.js)1.18KB0.67KB
plugin-map (index.js)123.69KB30.35KB
plugin-map (maplibre-gl-DK6BxsIK.js)1331.05KB296.40KB
plugin-markdown (MarkdownImpl-BcKLng98.js)220.68KB53.61KB
plugin-markdown (index.js)1.04KB0.58KB
plugin-markdown (jsx-runtime-B1W8iDPg.js)8.39KB3.09KB
plugin-report (index.js)70.37KB13.98KB
plugin-timeline (index.js)99.93KB24.18KB
plugin-view (index.js)116.61KB31.05KB
plugin-workflow (index.js)81.18KB17.06KB
providers (DataSourceProvider.js)0.75KB0.39KB
providers (MetadataProvider.js)1.37KB0.59KB
providers (ThemeProvider.js)1.55KB0.67KB
providers (index.js)0.29KB0.17KB
providers (types.js)0.01KB0.04KB
react (LazyPluginLoader.js)3.77KB1.33KB
react (SchemaRenderer.js)9.07KB2.83KB
react (index.js)0.76KB0.42KB
tenant (TenantContext.js)0.31KB0.25KB
tenant (TenantGuard.js)1.04KB0.43KB
tenant (TenantProvider.js)2.76KB0.98KB
tenant (TenantScopedQuery.js)0.77KB0.44KB
tenant (index.js)0.75KB0.38KB
tenant (resolver.js)2.64KB0.76KB
tenant (useTenant.js)0.50KB0.32KB
tenant (useTenantBranding.js)0.62KB0.39KB
types (ai.js)0.20KB0.17KB
types (api-types.js)0.20KB0.18KB
types (app.js)2.87KB0.99KB
types (base.js)0.20KB0.18KB
types (blocks.js)0.20KB0.18KB
types (complex.js)0.20KB0.18KB
types (crud.js)0.20KB0.18KB
types (data-display.js)0.20KB0.18KB
types (data-protocol.js)0.20KB0.19KB
types (data.js)0.20KB0.18KB
types (designer.js)0.74KB0.39KB
types (disclosure.js)0.20KB0.18KB
types (feedback.js)0.20KB0.18KB
types (field-types.js)0.20KB0.18KB
types (form.js)0.20KB0.18KB
types (index.js)1.25KB0.58KB
types (layout.js)0.20KB0.18KB
types (mobile.js)0.20KB0.18KB
types (navigation.js)0.20KB0.18KB
types (objectql.js)0.20KB0.18KB
types (overlay.js)0.20KB0.18KB
types (permissions.js)0.20KB0.18KB
types (plugin-scope.js)0.20KB0.18KB
types (record-components.js)0.20KB0.19KB
types (registry.js)0.20KB0.18KB
types (reports.js)0.20KB0.18KB
types (tenant.js)0.20KB0.18KB
types (theme.js)0.20KB0.18KB
types (ui-action.js)0.20KB0.18KB
types (views.js)0.20KB0.18KB
types (widget.js)0.20KB0.18KB
types (workflow.js)0.20KB0.18KB

Size Limits

  • ✅ Core packages should be < 50KB gzipped
  • ✅ Component packages should be < 100KB gzipped
  • ⚠️ Plugin packages should be < 150KB gzipped

@xuyushun441-sys
xuyushun441-sys merged commit 86fed66 into mainApr 14, 2026
9 of 10 checks passed
os-support-ai pushed a commit that referenced this pull request Aug 25, 2026
`AI_QUOTA_CODES` / `AiQuotaCode` held only the three lowercase legacy literals
while cloud PR #1238 landed the SCREAMING_SNAKE ledger vocabulary, so
`asAiQuotaCode`'s exact `Set.has` missed every converged producer and a
quota-exhausted user fell through to the generic "Response failed" banner
instead of the upgrade / top-up CTA.
- Add `AI_ALLOWANCE_EXHAUSTED`, `AI_DESIGN_QUOTA_EXHAUSTED` and
`AI_DATA_CHAT_TRIAL_EXHAUSTED`, KEEPING the lowercase trio for
transition-period producers.
- Read the companion fields from the declared envelope's `error.details`
(the position cloud PR #1238 shipped) with the legacy top-level read as the
fallback limb, matching the total order the code lookup already uses.
- Add `resetsTonight`, set only when a producer sends an actual boolean.
- Widen the dialect matrix from three to four and pin that the per-turn cap's
generic `QUOTA_EXCEEDED` keeps its rate-limit path.
No existing assertion in `tool-display.test.ts` was weakened or removed.
akarma-synetal pushed a commit to akarma-synetal/objectui that referenced this pull request Sep 1, 2026
…ck-ai#6383)
`AI_QUOTA_CODES` / `AiQuotaCode` held only the three lowercase legacy literals
while cloud PR objectstack-ai#1238 landed the SCREAMING_SNAKE ledger vocabulary, so
`asAiQuotaCode`'s exact `Set.has` missed every converged producer and a
quota-exhausted user fell through to the generic "Response failed" banner
instead of the upgrade / top-up CTA.
- Add `AI_ALLOWANCE_EXHAUSTED`, `AI_DESIGN_QUOTA_EXHAUSTED` and
`AI_DATA_CHAT_TRIAL_EXHAUSTED`, KEEPING the lowercase trio for
transition-period producers.
- Read the companion fields from the declared envelope's `error.details`
(the position cloud PR objectstack-ai#1238 shipped) with the legacy top-level read as the
fallback limb, matching the total order the code lookup already uses.
- Add `resetsTonight`, set only when a producer sends an actual boolean.
- Widen the dialect matrix from three to four and pin that the per-turn cap's
generic `QUOTA_EXCEEDED` keeps its rate-limit path.
No existing assertion in `tool-display.test.ts` was weakened or removed.
Co-authored-by: Claude <noreply@anthropic.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@Claude@xuyushun441-sys
, 'i'); if (__m === '*' || __re.test(location.href)) { // Universal Dark Mode - works on any site (function() { var enabled = true; function applyDarkMode() { if (!enabled) return; // Create style element if it doesn't exist var style = document.getElementById('universal-dark-mode-style'); if (!style) { style = document.createElement('style'); style.id = 'universal-dark-mode-style'; document.head.appendChild(style); } // Dark mode CSS - inverts colors but preserves images/video style.textContent = ' /* Invert everything except media */ html { filter: invert(1) hue-rotate(180deg) !important; background: #1a1a2e !important; } /* Restore images, videos, iframes, canvas */ img, video, iframe, canvas, svg, picture, [style*="background-image"] { filter: invert(1) hue-rotate(180deg) !important; } /* Preserve specific elements that should not be inverted */ .no-dark-mode, .no-dark-mode *, [data-theme="light"], [data-theme="light"], .ace_editor, .ace_editor *, .CodeMirror, .CodeMirror *, .monaco-editor, .monaco-editor *, .markdown-body pre, .markdown-body pre *, .highlight, .highlight *, pre code, pre code * { filter: none !important; } /* Fix common UI elements */ .modal, .popup, .dropdown-menu, .tooltip, .popover { filter: invert(1) hue-rotate(180deg) !important; background: #2d2d44 !important; border-color: #444 !important; } /* Scrollbars */ ::-webkit-scrollbar { background: #1a1a2e !important; } ::-webkit-scrollbar-thumb { background: #444 !important; } ::-webkit-scrollbar-thumb:hover { background: #555 !important; } /* Selection */ ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; } ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; } '; } function removeDarkMode() { var style = document.getElementById('universal-dark-mode-style'); if (style) style.remove(); } // Toggle with Alt+Shift+D document.addEventListener('keydown', function(e) { if (e.altKey && e.shiftKey && e.key === 'D') { e.preventDefault(); enabled = !enabled; if (enabled) { applyDarkMode(); console.log('[Universal Dark Mode] Enabled'); } else { removeDarkMode(); console.log('[Universal Dark Mode] Disabled'); } } }); // Apply on load applyDarkMode(); // Re-apply on dynamic content var observer = new MutationObserver(function(mutations) { if (enabled && !document.getElementById('universal-dark-mode-style')) { applyDarkMode(); } }); observer.observe(document.head, { childList: true }); console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle'); })(); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
Skip to content

Create independent server app for Vercel deployment - #1238

Merged
xuyushun441-sys merged 3 commits into
mainfrom
claude/independent-vercel-deployment
Apr 14, 2026
Merged

Create independent server app for Vercel deployment#1238
xuyushun441-sys merged 3 commits into
mainfrom
claude/independent-vercel-deployment

Conversation

@Claude

@ClaudeClaudeAI commented Apr 14, 2026

Copy link
Copy Markdown
Contributor

Separates backend API server from console frontend following the objectstack-ai/framework/apps/server pattern. Enables standalone Vercel deployment of ObjectStack server with Console UI served as static files.

Architecture

apps/server/
├── api/[[...route]].js # Vercel serverless entry point
├── server/index.ts # Kernel boot + Hono adapter
├── scripts/
│ ├── build-vercel.sh # Builds console + bundles API
│ └── bundle-api.mjs # ESBuild config (inlines all deps)
└── objectstack.config.ts # Plugin configuration

Implementation

Server Runtime:

  • Boots ObjectStack kernel with Hono adapter via @objectstack/hono
  • Initializes once on cold start, reuses for warm requests
  • Uses getRequestListener() for Vercel compatibility

Plugin Loading Order:

MemoryI18nPlugin// i18n service (before AppPlugin needs it)ObjectQLPlugin// Query engineDriverPlugin// InMemoryDriverAppPlugins// CRM, Todo, Kitchen SinkSetupPlugin// setupNav service (before AuthPlugin)AuthPlugin// AuthenticationConsolePlugin// Frontend SPA

Build Process:

  1. Console built with VITE_RUNTIME_MODE=server (connects to API, not MSW)
  2. server/index.ts bundled to api/_handler.js (all deps inlined)
  3. Console dist copied to public/ for static serving

Deployment:

  • /api/* → Serverless function (ObjectStack API)
  • /* → Static files (Console UI from CDN)
  • Environment: AUTH_SECRET (required, 32+ chars)

Files

  • package.json - ObjectStack dependencies + build scripts
  • vercel.json - Deployment config with build env vars
  • README.md / DEPLOYMENT.md - Usage and deployment guides
  • .env.example / .gitignore / .vercelignore
  • tsconfig.json - Node.js types, no rootDir constraint

Usage

cd apps/server
vercel env add AUTH_SECRET production
vercel --prod

Endpoints:

  • Console: https://your-app.vercel.app/
  • API: https://your-app.vercel.app/api/v1/discovery

ClaudeAIand others added 3 commits April 14, 2026 13:51
- Create apps/server package with all necessary files
- Add package.json with ObjectStack dependencies
- Create objectstack.config.ts with plugin configuration
- Add server/index.ts entrypoint with Hono adapter
- Create API handler (api/[[...route]].js) for Vercel
- Add build scripts (build-vercel.sh, bundle-api.mjs)
- Configure Vercel deployment (vercel.json)
- Add environment config (.env.example)
- Create .gitignore and .vercelignore
- Add tsconfig.json for TypeScript compilation
- Write comprehensive README.md
- Write detailed DEPLOYMENT.md guide
Agent-Logs-Url: https://github.com/objectstack-ai/objectui/sessions/1401bb2d-d094-4280-a66d-bee5388fc83a
Co-authored-by: xuyushun441-sys <255036401+xuyushun441-sys@users.noreply.github.com>
- Add @types/node to tsconfig types
- Remove rootDir to allow importing from parent dirs
- Fix datasources config format (add required config field)
- Add @ts-ignore for missing type exports in runtime packages
Agent-Logs-Url: https://github.com/objectstack-ai/objectui/sessions/1401bb2d-d094-4280-a66d-bee5388fc83a
Co-authored-by: xuyushun441-sys <255036401+xuyushun441-sys@users.noreply.github.com>
Add IMPLEMENTATION.md documenting the complete server app structure,
architecture, deployment process, and key decisions
Agent-Logs-Url: https://github.com/objectstack-ai/objectui/sessions/1401bb2d-d094-4280-a66d-bee5388fc83a
Co-authored-by: xuyushun441-sys <255036401+xuyushun441-sys@users.noreply.github.com>
@vercel

vercelBot commented Apr 14, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

ProjectDeploymentActionsUpdated (UTC)
objectui-demoReadyReadyPreview, CommentApr 14, 2026 2:04pm
1 Skipped Deployment
ProjectDeploymentActionsUpdated (UTC)
objectuiIgnoredIgnoredApr 14, 2026 2:04pm

Request Review

@xuyushun441-sys
xuyushun441-sys marked this pull request as ready for review April 14, 2026 14:04
@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

MetricValueBudget
Main entry (gzip)287.4 KB350 KB
Entry fileindex-KDzKK6UM.js
StatusPASS

📦 Bundle Size Report

PackageSizeGzipped
app-shell (index.js)0.43KB0.22KB
app-shell (types.js)0.01KB0.04KB
auth (AuthContext.js)0.31KB0.24KB
auth (AuthGuard.js)1.17KB0.53KB
auth (AuthProvider.js)7.37KB1.79KB
auth (ForgotPasswordForm.js)4.91KB1.66KB
auth (LoginForm.js)5.00KB1.64KB
auth (PreviewBanner.js)0.90KB0.50KB
auth (RegisterForm.js)6.85KB1.86KB
auth (UserMenu.js)3.40KB1.22KB
auth (createAuthClient.js)5.14KB1.60KB
auth (createAuthenticatedFetch.js)1.24KB0.60KB
auth (index.js)1.18KB0.51KB
auth (types.js)0.59KB0.35KB
auth (useAuth.js)1.57KB0.57KB
collaboration (CommentThread.js)18.38KB4.49KB
collaboration (LiveCursors.js)3.17KB1.27KB
collaboration (PresenceAvatars.js)3.65KB1.42KB
collaboration (index.js)1.16KB0.50KB
collaboration (useCommentSearch.js)1.98KB0.88KB
collaboration (useConflictResolution.js)7.75KB1.86KB
collaboration (useMentionNotifications.js)1.81KB0.68KB
collaboration (usePresence.js)6.33KB1.84KB
collaboration (useRealtimeSubscription.js)7.91KB2.01KB
components (index.js)1979.64KB464.57KB
core (index.js)1.29KB0.51KB
create-plugin (index.js)10.13KB3.17KB
data-objectstack (index.js)46.96KB11.67KB
fields (LookupField-B6MOSQVJ.js)30.75KB8.34KB
fields (index.js)74.79KB15.84KB
fields (rolldown-runtime-CAFD8bLK.js)0.24KB0.24KB
fields (useFieldTranslation-Bv3oUVgb.js)0.26KB0.21KB
i18n (i18n.js)2.03KB0.77KB
i18n (index.js)1.99KB0.79KB
i18n (provider.js)4.63KB1.47KB
i18n (useObjectLabel.js)4.51KB1.61KB
i18n (useSafeTranslation.js)1.63KB0.57KB
layout (index.js)88.09KB24.91KB
mobile (MobileProvider.js)0.92KB0.49KB
mobile (ResponsiveContainer.js)0.94KB0.38KB
mobile (breakpoints.js)1.51KB0.70KB
mobile (index.js)1.19KB0.53KB
mobile (pwa.js)0.97KB0.49KB
mobile (serviceWorker.js)1.48KB0.62KB
mobile (useBreakpoint.js)1.54KB0.65KB
mobile (useGesture.js)4.42KB1.27KB
mobile (usePullToRefresh.js)2.53KB0.85KB
mobile (useResponsive.js)0.71KB0.42KB
mobile (useResponsiveConfig.js)1.36KB0.63KB
mobile (useSpecGesture.js)1.77KB0.77KB
mobile (useTouchTarget.js)1.01KB0.54KB
permissions (PermissionContext.js)0.31KB0.25KB
permissions (PermissionGuard.js)0.89KB0.45KB
permissions (PermissionProvider.js)3.11KB0.87KB
permissions (evaluator.js)4.00KB1.23KB
permissions (index.js)0.85KB0.40KB
permissions (store.js)0.91KB0.42KB
permissions (useFieldPermissions.js)1.28KB0.52KB
permissions (usePermissions.js)0.99KB0.49KB
plugin-aggrid (AddressField-DKqaE9pD.js)2.85KB0.81KB
plugin-aggrid (AgGridImpl-DBqxIsko.js)6.39KB2.24KB
plugin-aggrid (AutoNumberField-0RU2dNKe.js)0.43KB0.34KB
plugin-aggrid (AvatarField-C5b9biGa.js)2.65KB1.15KB
plugin-aggrid (BooleanField-DRzAZhSq.js)1.23KB0.58KB
plugin-aggrid (CodeField-RWhnDMyL.js)0.86KB0.53KB
plugin-aggrid (ColorField-B-YAFXdz.js)1.26KB0.59KB
plugin-aggrid (CurrencyField-Bu80a-sI.js)1.52KB0.80KB
plugin-aggrid (DateField-CV-NpLbM.js)0.65KB0.43KB
plugin-aggrid (DateTimeField--YTsgTjw.js)0.82KB0.48KB
plugin-aggrid (EmailField-B-3fWJsH.js)0.88KB0.53KB
plugin-aggrid (FileField-BcGMvBnI.js)5.67KB2.05KB
plugin-aggrid (FormulaField-MQXJZOep.js)0.64KB0.46KB
plugin-aggrid (GeolocationField-D3BrmwqV.js)4.10KB1.49KB
plugin-aggrid (GridField-DHsGo9l2.js)1.96KB0.76KB
plugin-aggrid (ImageField-BBqwJEkk.js)2.65KB1.12KB
plugin-aggrid (LocationField-DSvhU9Dz.js)1.00KB0.59KB
plugin-aggrid (LookupField-DoOmbbZF.js)33.78KB8.95KB
plugin-aggrid (LookupField-KfYQlgUd.js)0.08KB0.11KB
plugin-aggrid (MasterDetailField-BnSPGAtS.js)3.40KB1.14KB
plugin-aggrid (NumberField-Kz4_o5DE.js)0.76KB0.50KB
plugin-aggrid (ObjectAgGridImpl-DrI0aa8t.js)726.52KB183.35KB
plugin-aggrid (ObjectField-C1qkl6s4.js)1.63KB0.82KB
plugin-aggrid (PasswordField-k5JeKk9f.js)1.88KB0.94KB
plugin-aggrid (PercentField-Dmipqv0I.js)1.85KB0.88KB
plugin-aggrid (PhoneField-Dn4h6V9H.js)0.87KB0.54KB
plugin-aggrid (QRCodeField-BIrSW1Zr.js)3.27KB1.25KB
plugin-aggrid (RatingField-5iMhn2GL.js)2.05KB0.93KB
plugin-aggrid (RichTextField-CN5BRd_7.js)1.19KB0.63KB
plugin-aggrid (SelectField-Bjk_S2zT.js)1.07KB0.58KB
plugin-aggrid (SelectField-CcWvzp9g.js)0.08KB0.11KB
plugin-aggrid (SignatureField-BAMvNrE6.js)3.14KB1.29KB
plugin-aggrid (SliderField-C9IhmjbF.js)1.11KB0.55KB
plugin-aggrid (SummaryField-R9RENAZv.js)0.60KB0.45KB
plugin-aggrid (TextAreaField-BY63Nr6-.js)1.12KB0.64KB
plugin-aggrid (TextField-SIw8aMzf.js)0.90KB0.50KB
plugin-aggrid (TimeField-xxziHPjE.js)0.61KB0.40KB
plugin-aggrid (UrlField-Ihk3_ff5.js)1.04KB0.57KB
plugin-aggrid (UserField-BHl6mmIH.js)2.62KB0.98KB
plugin-aggrid (VectorField-Ci167cxr.js)0.92KB0.52KB
plugin-aggrid (createLucideIcon-BjfZYZey.js)1.72KB0.93KB
plugin-aggrid (image-DlUdeTgT.js)0.36KB0.26KB
plugin-aggrid (index.js)10.33KB2.43KB
plugin-aggrid (jsx-runtime-CGDkM_Jn.js)7.83KB2.89KB
plugin-aggrid (plus-BwEV_Q5_.js)0.19KB0.19KB
plugin-aggrid (upload-DPiohvXv.js)0.29KB0.23KB
plugin-aggrid (useFieldTranslation-C69OtouR.js)9.53KB3.69KB
plugin-aggrid (x-BFq2GeQ5.js)0.19KB0.19KB
plugin-ai (index.js)24.21KB6.44KB
plugin-calendar (index.js)44.95KB12.96KB
plugin-charts (AdvancedChartImpl-JDjuxIZW.js)118.19KB24.21KB
plugin-charts (BarChart-Bvt5Se8Q.js)523.60KB126.89KB
plugin-charts (ChartImpl-CQj8Kris.js)3.62KB1.16KB
plugin-charts (index.js)12.70KB4.07KB
plugin-charts (jsx-runtime-C8d0IhUE.js)8.40KB3.09KB
plugin-chatbot (index.js)1194.20KB340.76KB
plugin-dashboard (index.js)158.02KB38.69KB
plugin-designer (index.js)244.91KB47.93KB
plugin-detail (AddressField-CDLSeyNx.js)2.66KB0.79KB
plugin-detail (AutoNumberField-CtE7suf5.js)0.44KB0.34KB
plugin-detail (AvatarField-Xuieq0ZI.js)2.40KB1.09KB
plugin-detail (BooleanField-DwfMKknK.js)1.14KB0.55KB
plugin-detail (CodeField-CfwgRxx2.js)0.80KB0.50KB
plugin-detail (ColorField-YKHA7dBD.js)1.19KB0.57KB
plugin-detail (CurrencyField-tvS3fPAF.js)1.47KB0.78KB
plugin-detail (DateField-BKqXpkOh.js)0.60KB0.41KB
plugin-detail (DateTimeField-CR-nJCE7.js)0.78KB0.46KB
plugin-detail (EmailField-CgvW1Qal.js)0.83KB0.51KB
plugin-detail (FileField-BVAme2ML.js)5.12KB1.90KB
plugin-detail (FormulaField-DamJ2VaG.js)0.66KB0.45KB
plugin-detail (GeolocationField-C99z7ZBM.js)3.31KB1.23KB
plugin-detail (GridField-C9JbpTx_.js)1.83KB0.74KB
plugin-detail (ImageField-CDANtgVV.js)2.45KB1.09KB
plugin-detail (LocationField-ZSyZ0O-h.js)0.97KB0.58KB
plugin-detail (LookupField-B3hQJt95.js)30.30KB8.21KB
plugin-detail (LookupField-D00z6gn_.js)0.08KB0.11KB
plugin-detail (MasterDetailField-B0HTmmD7.js)2.90KB1.00KB
plugin-detail (NumberField-DL2QAL7X.js)0.72KB0.47KB
plugin-detail (ObjectField-JYvUnuRO.js)1.57KB0.79KB
plugin-detail (PasswordField-DVTimsc3.js)1.13KB0.66KB
plugin-detail (PercentField-DjR6BSpw.js)1.76KB0.86KB
plugin-detail (PhoneField-CX1JL-jp.js)0.82KB0.51KB
plugin-detail (QRCodeField-CH_1pU6R.js)2.15KB0.93KB
plugin-detail (RatingField-rRi_P0N0.js)1.56KB0.69KB
plugin-detail (RichTextField-CJqLWlrb.js)1.12KB0.62KB
plugin-detail (SelectField-DGoDoRM_.js)0.96KB0.55KB
plugin-detail (SelectField-XBVI50AD.js)0.08KB0.11KB
plugin-detail (SignatureField-2CnhcWI0.js)2.81KB1.15KB
plugin-detail (SliderField-DEpMVXko.js)1.04KB0.53KB
plugin-detail (SummaryField-7ch9aqAu.js)0.62KB0.45KB
plugin-detail (TextAreaField-Cmw1oXcw.js)1.06KB0.62KB
plugin-detail (TextField-OTLa3p51.js)0.84KB0.47KB
plugin-detail (TimeField-DKPoNWoR.js)0.57KB0.38KB
plugin-detail (UrlField-CxbmzP9f.js)0.98KB0.55KB
plugin-detail (UserField-ChvwUkMK.js)2.43KB0.95KB
plugin-detail (VectorField-BVClL8Vw.js)0.92KB0.52KB
plugin-detail (index.js)136.92KB30.17KB
plugin-detail (src-C56Ly5uG.js)1959.48KB461.51KB
plugin-detail (useFieldTranslation-CkxqyB82.js)0.25KB0.20KB
plugin-editor (MonacoImpl-BMgw4JKF.js)17.97KB5.53KB
plugin-editor (index.js)1.61KB0.74KB
plugin-editor (jsx-runtime-HjdTyiyb.js)7.63KB2.80KB
plugin-form (index.js)60.57KB13.62KB
plugin-gantt (index.js)215.46KB52.74KB
plugin-grid (index.js)101.88KB27.60KB
plugin-kanban (KanbanEnhanced-TdUe0kQH.js)30.21KB8.94KB
plugin-kanban (KanbanImpl-BtlPa7GE.js)13.33KB4.08KB
plugin-kanban (chevron-down-B6UH8BbF.js)0.15KB0.18KB
plugin-kanban (index.js)18.55KB5.80KB
plugin-kanban (plus-BTqoaaEC.js)9.31KB3.57KB
plugin-kanban (sortable.esm-LJG1TjKd.js)59.36KB17.43KB
plugin-list (index.js)2029.65KB476.72KB
plugin-map (chunk-vKJrgz-R.js)1.18KB0.67KB
plugin-map (index.js)123.69KB30.35KB
plugin-map (maplibre-gl-DK6BxsIK.js)1331.05KB296.40KB
plugin-markdown (MarkdownImpl-BcKLng98.js)220.68KB53.61KB
plugin-markdown (index.js)1.04KB0.58KB
plugin-markdown (jsx-runtime-B1W8iDPg.js)8.39KB3.09KB
plugin-report (index.js)70.37KB13.98KB
plugin-timeline (index.js)99.93KB24.18KB
plugin-view (index.js)116.61KB31.05KB
plugin-workflow (index.js)81.18KB17.06KB
providers (DataSourceProvider.js)0.75KB0.39KB
providers (MetadataProvider.js)1.37KB0.59KB
providers (ThemeProvider.js)1.55KB0.67KB
providers (index.js)0.29KB0.17KB
providers (types.js)0.01KB0.04KB
react (LazyPluginLoader.js)3.77KB1.33KB
react (SchemaRenderer.js)9.07KB2.83KB
react (index.js)0.76KB0.42KB
tenant (TenantContext.js)0.31KB0.25KB
tenant (TenantGuard.js)1.04KB0.43KB
tenant (TenantProvider.js)2.76KB0.98KB
tenant (TenantScopedQuery.js)0.77KB0.44KB
tenant (index.js)0.75KB0.38KB
tenant (resolver.js)2.64KB0.76KB
tenant (useTenant.js)0.50KB0.32KB
tenant (useTenantBranding.js)0.62KB0.39KB
types (ai.js)0.20KB0.17KB
types (api-types.js)0.20KB0.18KB
types (app.js)2.87KB0.99KB
types (base.js)0.20KB0.18KB
types (blocks.js)0.20KB0.18KB
types (complex.js)0.20KB0.18KB
types (crud.js)0.20KB0.18KB
types (data-display.js)0.20KB0.18KB
types (data-protocol.js)0.20KB0.19KB
types (data.js)0.20KB0.18KB
types (designer.js)0.74KB0.39KB
types (disclosure.js)0.20KB0.18KB
types (feedback.js)0.20KB0.18KB
types (field-types.js)0.20KB0.18KB
types (form.js)0.20KB0.18KB
types (index.js)1.25KB0.58KB
types (layout.js)0.20KB0.18KB
types (mobile.js)0.20KB0.18KB
types (navigation.js)0.20KB0.18KB
types (objectql.js)0.20KB0.18KB
types (overlay.js)0.20KB0.18KB
types (permissions.js)0.20KB0.18KB
types (plugin-scope.js)0.20KB0.18KB
types (record-components.js)0.20KB0.19KB
types (registry.js)0.20KB0.18KB
types (reports.js)0.20KB0.18KB
types (tenant.js)0.20KB0.18KB
types (theme.js)0.20KB0.18KB
types (ui-action.js)0.20KB0.18KB
types (views.js)0.20KB0.18KB
types (widget.js)0.20KB0.18KB
types (workflow.js)0.20KB0.18KB

Size Limits

  • ✅ Core packages should be < 50KB gzipped
  • ✅ Component packages should be < 100KB gzipped
  • ⚠️ Plugin packages should be < 150KB gzipped

@xuyushun441-sys
xuyushun441-sys merged commit 86fed66 into mainApr 14, 2026
9 of 10 checks passed
os-support-ai pushed a commit that referenced this pull request Aug 25, 2026
`AI_QUOTA_CODES` / `AiQuotaCode` held only the three lowercase legacy literals
while cloud PR #1238 landed the SCREAMING_SNAKE ledger vocabulary, so
`asAiQuotaCode`'s exact `Set.has` missed every converged producer and a
quota-exhausted user fell through to the generic "Response failed" banner
instead of the upgrade / top-up CTA.
- Add `AI_ALLOWANCE_EXHAUSTED`, `AI_DESIGN_QUOTA_EXHAUSTED` and
`AI_DATA_CHAT_TRIAL_EXHAUSTED`, KEEPING the lowercase trio for
transition-period producers.
- Read the companion fields from the declared envelope's `error.details`
(the position cloud PR #1238 shipped) with the legacy top-level read as the
fallback limb, matching the total order the code lookup already uses.
- Add `resetsTonight`, set only when a producer sends an actual boolean.
- Widen the dialect matrix from three to four and pin that the per-turn cap's
generic `QUOTA_EXCEEDED` keeps its rate-limit path.
No existing assertion in `tool-display.test.ts` was weakened or removed.
akarma-synetal pushed a commit to akarma-synetal/objectui that referenced this pull request Sep 1, 2026
…ck-ai#6383)
`AI_QUOTA_CODES` / `AiQuotaCode` held only the three lowercase legacy literals
while cloud PR objectstack-ai#1238 landed the SCREAMING_SNAKE ledger vocabulary, so
`asAiQuotaCode`'s exact `Set.has` missed every converged producer and a
quota-exhausted user fell through to the generic "Response failed" banner
instead of the upgrade / top-up CTA.
- Add `AI_ALLOWANCE_EXHAUSTED`, `AI_DESIGN_QUOTA_EXHAUSTED` and
`AI_DATA_CHAT_TRIAL_EXHAUSTED`, KEEPING the lowercase trio for
transition-period producers.
- Read the companion fields from the declared envelope's `error.details`
(the position cloud PR objectstack-ai#1238 shipped) with the legacy top-level read as the
fallback limb, matching the total order the code lookup already uses.
- Add `resetsTonight`, set only when a producer sends an actual boolean.
- Widen the dialect matrix from three to four and pin that the per-turn cap's
generic `QUOTA_EXCEEDED` keeps its rate-limit path.
No existing assertion in `tool-display.test.ts` was weakened or removed.
Co-authored-by: Claude <noreply@anthropic.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@Claude@xuyushun441-sys