Skip to content

Create independent server app for Vercel deployment#1238

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

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

Conversation

@Claude
Copy link
Copy Markdown
Contributor

@Claude Claude AI commented Apr 14, 2026

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 engine
 DriverPlugin            // InMemoryDriver
 AppPlugins              // CRM, Todo, Kitchen Sink
 SetupPlugin             // setupNav service (before AuthPlugin)
 AuthPlugin              // Authentication
 ConsolePlugin           // 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

Claude AI and 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
Copy link
Copy Markdown

vercel bot commented Apr 14, 2026

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

Project Deployment Actions Updated (UTC)
objectui-demo Ready Ready Preview, Comment Apr 14, 2026 2:04pm
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
objectui Ignored Ignored Apr 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

Metric Value Budget
Main entry (gzip) 287.4 KB 350 KB
Entry file index-KDzKK6UM.js
Status PASS

📦 Bundle Size Report

Package Size Gzipped
app-shell (index.js) 0.43KB 0.22KB
app-shell (types.js) 0.01KB 0.04KB
auth (AuthContext.js) 0.31KB 0.24KB
auth (AuthGuard.js) 1.17KB 0.53KB
auth (AuthProvider.js) 7.37KB 1.79KB
auth (ForgotPasswordForm.js) 4.91KB 1.66KB
auth (LoginForm.js) 5.00KB 1.64KB
auth (PreviewBanner.js) 0.90KB 0.50KB
auth (RegisterForm.js) 6.85KB 1.86KB
auth (UserMenu.js) 3.40KB 1.22KB
auth (createAuthClient.js) 5.14KB 1.60KB
auth (createAuthenticatedFetch.js) 1.24KB 0.60KB
auth (index.js) 1.18KB 0.51KB
auth (types.js) 0.59KB 0.35KB
auth (useAuth.js) 1.57KB 0.57KB
collaboration (CommentThread.js) 18.38KB 4.49KB
collaboration (LiveCursors.js) 3.17KB 1.27KB
collaboration (PresenceAvatars.js) 3.65KB 1.42KB
collaboration (index.js) 1.16KB 0.50KB
collaboration (useCommentSearch.js) 1.98KB 0.88KB
collaboration (useConflictResolution.js) 7.75KB 1.86KB
collaboration (useMentionNotifications.js) 1.81KB 0.68KB
collaboration (usePresence.js) 6.33KB 1.84KB
collaboration (useRealtimeSubscription.js) 7.91KB 2.01KB
components (index.js) 1979.64KB 464.57KB
core (index.js) 1.29KB 0.51KB
create-plugin (index.js) 10.13KB 3.17KB
data-objectstack (index.js) 46.96KB 11.67KB
fields (LookupField-B6MOSQVJ.js) 30.75KB 8.34KB
fields (index.js) 74.79KB 15.84KB
fields (rolldown-runtime-CAFD8bLK.js) 0.24KB 0.24KB
fields (useFieldTranslation-Bv3oUVgb.js) 0.26KB 0.21KB
i18n (i18n.js) 2.03KB 0.77KB
i18n (index.js) 1.99KB 0.79KB
i18n (provider.js) 4.63KB 1.47KB
i18n (useObjectLabel.js) 4.51KB 1.61KB
i18n (useSafeTranslation.js) 1.63KB 0.57KB
layout (index.js) 88.09KB 24.91KB
mobile (MobileProvider.js) 0.92KB 0.49KB
mobile (ResponsiveContainer.js) 0.94KB 0.38KB
mobile (breakpoints.js) 1.51KB 0.70KB
mobile (index.js) 1.19KB 0.53KB
mobile (pwa.js) 0.97KB 0.49KB
mobile (serviceWorker.js) 1.48KB 0.62KB
mobile (useBreakpoint.js) 1.54KB 0.65KB
mobile (useGesture.js) 4.42KB 1.27KB
mobile (usePullToRefresh.js) 2.53KB 0.85KB
mobile (useResponsive.js) 0.71KB 0.42KB
mobile (useResponsiveConfig.js) 1.36KB 0.63KB
mobile (useSpecGesture.js) 1.77KB 0.77KB
mobile (useTouchTarget.js) 1.01KB 0.54KB
permissions (PermissionContext.js) 0.31KB 0.25KB
permissions (PermissionGuard.js) 0.89KB 0.45KB
permissions (PermissionProvider.js) 3.11KB 0.87KB
permissions (evaluator.js) 4.00KB 1.23KB
permissions (index.js) 0.85KB 0.40KB
permissions (store.js) 0.91KB 0.42KB
permissions (useFieldPermissions.js) 1.28KB 0.52KB
permissions (usePermissions.js) 0.99KB 0.49KB
plugin-aggrid (AddressField-DKqaE9pD.js) 2.85KB 0.81KB
plugin-aggrid (AgGridImpl-DBqxIsko.js) 6.39KB 2.24KB
plugin-aggrid (AutoNumberField-0RU2dNKe.js) 0.43KB 0.34KB
plugin-aggrid (AvatarField-C5b9biGa.js) 2.65KB 1.15KB
plugin-aggrid (BooleanField-DRzAZhSq.js) 1.23KB 0.58KB
plugin-aggrid (CodeField-RWhnDMyL.js) 0.86KB 0.53KB
plugin-aggrid (ColorField-B-YAFXdz.js) 1.26KB 0.59KB
plugin-aggrid (CurrencyField-Bu80a-sI.js) 1.52KB 0.80KB
plugin-aggrid (DateField-CV-NpLbM.js) 0.65KB 0.43KB
plugin-aggrid (DateTimeField--YTsgTjw.js) 0.82KB 0.48KB
plugin-aggrid (EmailField-B-3fWJsH.js) 0.88KB 0.53KB
plugin-aggrid (FileField-BcGMvBnI.js) 5.67KB 2.05KB
plugin-aggrid (FormulaField-MQXJZOep.js) 0.64KB 0.46KB
plugin-aggrid (GeolocationField-D3BrmwqV.js) 4.10KB 1.49KB
plugin-aggrid (GridField-DHsGo9l2.js) 1.96KB 0.76KB
plugin-aggrid (ImageField-BBqwJEkk.js) 2.65KB 1.12KB
plugin-aggrid (LocationField-DSvhU9Dz.js) 1.00KB 0.59KB
plugin-aggrid (LookupField-DoOmbbZF.js) 33.78KB 8.95KB
plugin-aggrid (LookupField-KfYQlgUd.js) 0.08KB 0.11KB
plugin-aggrid (MasterDetailField-BnSPGAtS.js) 3.40KB 1.14KB
plugin-aggrid (NumberField-Kz4_o5DE.js) 0.76KB 0.50KB
plugin-aggrid (ObjectAgGridImpl-DrI0aa8t.js) 726.52KB 183.35KB
plugin-aggrid (ObjectField-C1qkl6s4.js) 1.63KB 0.82KB
plugin-aggrid (PasswordField-k5JeKk9f.js) 1.88KB 0.94KB
plugin-aggrid (PercentField-Dmipqv0I.js) 1.85KB 0.88KB
plugin-aggrid (PhoneField-Dn4h6V9H.js) 0.87KB 0.54KB
plugin-aggrid (QRCodeField-BIrSW1Zr.js) 3.27KB 1.25KB
plugin-aggrid (RatingField-5iMhn2GL.js) 2.05KB 0.93KB
plugin-aggrid (RichTextField-CN5BRd_7.js) 1.19KB 0.63KB
plugin-aggrid (SelectField-Bjk_S2zT.js) 1.07KB 0.58KB
plugin-aggrid (SelectField-CcWvzp9g.js) 0.08KB 0.11KB
plugin-aggrid (SignatureField-BAMvNrE6.js) 3.14KB 1.29KB
plugin-aggrid (SliderField-C9IhmjbF.js) 1.11KB 0.55KB
plugin-aggrid (SummaryField-R9RENAZv.js) 0.60KB 0.45KB
plugin-aggrid (TextAreaField-BY63Nr6-.js) 1.12KB 0.64KB
plugin-aggrid (TextField-SIw8aMzf.js) 0.90KB 0.50KB
plugin-aggrid (TimeField-xxziHPjE.js) 0.61KB 0.40KB
plugin-aggrid (UrlField-Ihk3_ff5.js) 1.04KB 0.57KB
plugin-aggrid (UserField-BHl6mmIH.js) 2.62KB 0.98KB
plugin-aggrid (VectorField-Ci167cxr.js) 0.92KB 0.52KB
plugin-aggrid (createLucideIcon-BjfZYZey.js) 1.72KB 0.93KB
plugin-aggrid (image-DlUdeTgT.js) 0.36KB 0.26KB
plugin-aggrid (index.js) 10.33KB 2.43KB
plugin-aggrid (jsx-runtime-CGDkM_Jn.js) 7.83KB 2.89KB
plugin-aggrid (plus-BwEV_Q5_.js) 0.19KB 0.19KB
plugin-aggrid (upload-DPiohvXv.js) 0.29KB 0.23KB
plugin-aggrid (useFieldTranslation-C69OtouR.js) 9.53KB 3.69KB
plugin-aggrid (x-BFq2GeQ5.js) 0.19KB 0.19KB
plugin-ai (index.js) 24.21KB 6.44KB
plugin-calendar (index.js) 44.95KB 12.96KB
plugin-charts (AdvancedChartImpl-JDjuxIZW.js) 118.19KB 24.21KB
plugin-charts (BarChart-Bvt5Se8Q.js) 523.60KB 126.89KB
plugin-charts (ChartImpl-CQj8Kris.js) 3.62KB 1.16KB
plugin-charts (index.js) 12.70KB 4.07KB
plugin-charts (jsx-runtime-C8d0IhUE.js) 8.40KB 3.09KB
plugin-chatbot (index.js) 1194.20KB 340.76KB
plugin-dashboard (index.js) 158.02KB 38.69KB
plugin-designer (index.js) 244.91KB 47.93KB
plugin-detail (AddressField-CDLSeyNx.js) 2.66KB 0.79KB
plugin-detail (AutoNumberField-CtE7suf5.js) 0.44KB 0.34KB
plugin-detail (AvatarField-Xuieq0ZI.js) 2.40KB 1.09KB
plugin-detail (BooleanField-DwfMKknK.js) 1.14KB 0.55KB
plugin-detail (CodeField-CfwgRxx2.js) 0.80KB 0.50KB
plugin-detail (ColorField-YKHA7dBD.js) 1.19KB 0.57KB
plugin-detail (CurrencyField-tvS3fPAF.js) 1.47KB 0.78KB
plugin-detail (DateField-BKqXpkOh.js) 0.60KB 0.41KB
plugin-detail (DateTimeField-CR-nJCE7.js) 0.78KB 0.46KB
plugin-detail (EmailField-CgvW1Qal.js) 0.83KB 0.51KB
plugin-detail (FileField-BVAme2ML.js) 5.12KB 1.90KB
plugin-detail (FormulaField-DamJ2VaG.js) 0.66KB 0.45KB
plugin-detail (GeolocationField-C99z7ZBM.js) 3.31KB 1.23KB
plugin-detail (GridField-C9JbpTx_.js) 1.83KB 0.74KB
plugin-detail (ImageField-CDANtgVV.js) 2.45KB 1.09KB
plugin-detail (LocationField-ZSyZ0O-h.js) 0.97KB 0.58KB
plugin-detail (LookupField-B3hQJt95.js) 30.30KB 8.21KB
plugin-detail (LookupField-D00z6gn_.js) 0.08KB 0.11KB
plugin-detail (MasterDetailField-B0HTmmD7.js) 2.90KB 1.00KB
plugin-detail (NumberField-DL2QAL7X.js) 0.72KB 0.47KB
plugin-detail (ObjectField-JYvUnuRO.js) 1.57KB 0.79KB
plugin-detail (PasswordField-DVTimsc3.js) 1.13KB 0.66KB
plugin-detail (PercentField-DjR6BSpw.js) 1.76KB 0.86KB
plugin-detail (PhoneField-CX1JL-jp.js) 0.82KB 0.51KB
plugin-detail (QRCodeField-CH_1pU6R.js) 2.15KB 0.93KB
plugin-detail (RatingField-rRi_P0N0.js) 1.56KB 0.69KB
plugin-detail (RichTextField-CJqLWlrb.js) 1.12KB 0.62KB
plugin-detail (SelectField-DGoDoRM_.js) 0.96KB 0.55KB
plugin-detail (SelectField-XBVI50AD.js) 0.08KB 0.11KB
plugin-detail (SignatureField-2CnhcWI0.js) 2.81KB 1.15KB
plugin-detail (SliderField-DEpMVXko.js) 1.04KB 0.53KB
plugin-detail (SummaryField-7ch9aqAu.js) 0.62KB 0.45KB
plugin-detail (TextAreaField-Cmw1oXcw.js) 1.06KB 0.62KB
plugin-detail (TextField-OTLa3p51.js) 0.84KB 0.47KB
plugin-detail (TimeField-DKPoNWoR.js) 0.57KB 0.38KB
plugin-detail (UrlField-CxbmzP9f.js) 0.98KB 0.55KB
plugin-detail (UserField-ChvwUkMK.js) 2.43KB 0.95KB
plugin-detail (VectorField-BVClL8Vw.js) 0.92KB 0.52KB
plugin-detail (index.js) 136.92KB 30.17KB
plugin-detail (src-C56Ly5uG.js) 1959.48KB 461.51KB
plugin-detail (useFieldTranslation-CkxqyB82.js) 0.25KB 0.20KB
plugin-editor (MonacoImpl-BMgw4JKF.js) 17.97KB 5.53KB
plugin-editor (index.js) 1.61KB 0.74KB
plugin-editor (jsx-runtime-HjdTyiyb.js) 7.63KB 2.80KB
plugin-form (index.js) 60.57KB 13.62KB
plugin-gantt (index.js) 215.46KB 52.74KB
plugin-grid (index.js) 101.88KB 27.60KB
plugin-kanban (KanbanEnhanced-TdUe0kQH.js) 30.21KB 8.94KB
plugin-kanban (KanbanImpl-BtlPa7GE.js) 13.33KB 4.08KB
plugin-kanban (chevron-down-B6UH8BbF.js) 0.15KB 0.18KB
plugin-kanban (index.js) 18.55KB 5.80KB
plugin-kanban (plus-BTqoaaEC.js) 9.31KB 3.57KB
plugin-kanban (sortable.esm-LJG1TjKd.js) 59.36KB 17.43KB
plugin-list (index.js) 2029.65KB 476.72KB
plugin-map (chunk-vKJrgz-R.js) 1.18KB 0.67KB
plugin-map (index.js) 123.69KB 30.35KB
plugin-map (maplibre-gl-DK6BxsIK.js) 1331.05KB 296.40KB
plugin-markdown (MarkdownImpl-BcKLng98.js) 220.68KB 53.61KB
plugin-markdown (index.js) 1.04KB 0.58KB
plugin-markdown (jsx-runtime-B1W8iDPg.js) 8.39KB 3.09KB
plugin-report (index.js) 70.37KB 13.98KB
plugin-timeline (index.js) 99.93KB 24.18KB
plugin-view (index.js) 116.61KB 31.05KB
plugin-workflow (index.js) 81.18KB 17.06KB
providers (DataSourceProvider.js) 0.75KB 0.39KB
providers (MetadataProvider.js) 1.37KB 0.59KB
providers (ThemeProvider.js) 1.55KB 0.67KB
providers (index.js) 0.29KB 0.17KB
providers (types.js) 0.01KB 0.04KB
react (LazyPluginLoader.js) 3.77KB 1.33KB
react (SchemaRenderer.js) 9.07KB 2.83KB
react (index.js) 0.76KB 0.42KB
tenant (TenantContext.js) 0.31KB 0.25KB
tenant (TenantGuard.js) 1.04KB 0.43KB
tenant (TenantProvider.js) 2.76KB 0.98KB
tenant (TenantScopedQuery.js) 0.77KB 0.44KB
tenant (index.js) 0.75KB 0.38KB
tenant (resolver.js) 2.64KB 0.76KB
tenant (useTenant.js) 0.50KB 0.32KB
tenant (useTenantBranding.js) 0.62KB 0.39KB
types (ai.js) 0.20KB 0.17KB
types (api-types.js) 0.20KB 0.18KB
types (app.js) 2.87KB 0.99KB
types (base.js) 0.20KB 0.18KB
types (blocks.js) 0.20KB 0.18KB
types (complex.js) 0.20KB 0.18KB
types (crud.js) 0.20KB 0.18KB
types (data-display.js) 0.20KB 0.18KB
types (data-protocol.js) 0.20KB 0.19KB
types (data.js) 0.20KB 0.18KB
types (designer.js) 0.74KB 0.39KB
types (disclosure.js) 0.20KB 0.18KB
types (feedback.js) 0.20KB 0.18KB
types (field-types.js) 0.20KB 0.18KB
types (form.js) 0.20KB 0.18KB
types (index.js) 1.25KB 0.58KB
types (layout.js) 0.20KB 0.18KB
types (mobile.js) 0.20KB 0.18KB
types (navigation.js) 0.20KB 0.18KB
types (objectql.js) 0.20KB 0.18KB
types (overlay.js) 0.20KB 0.18KB
types (permissions.js) 0.20KB 0.18KB
types (plugin-scope.js) 0.20KB 0.18KB
types (record-components.js) 0.20KB 0.19KB
types (registry.js) 0.20KB 0.18KB
types (reports.js) 0.20KB 0.18KB
types (tenant.js) 0.20KB 0.18KB
types (theme.js) 0.20KB 0.18KB
types (ui-action.js) 0.20KB 0.18KB
types (views.js) 0.20KB 0.18KB
types (widget.js) 0.20KB 0.18KB
types (workflow.js) 0.20KB 0.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 main Apr 14, 2026
9 of 10 checks passed
Sign up for free to 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