Nogbase Front

nogbase-front is the reusable front-engine package for Nogbase app surfaces. It is the place to port and build object-record UI, saved-view behavior, spreadsheet-import flows, app shell primitives, and future engine screens.

The starter app consumes this package instead of owning engine code directly.

Current Contents

• components/NogbaseEngineStarterPage
  • starter engine page using nogbase-ui,
  • demonstrates records, saved-view deltas, and spreadsheet import mapping.
• views/buildViewChangeSet
  • separates saved-view filters and sorts into create/update/delete buckets.
• spreadsheet-import/suggestSpreadsheetColumnMatches
  • matches uploaded spreadsheet headers to field definitions,
  • handles checkbox/select/multi-select column types,
  • detects unmatched required fields.

Commands

From the workspace root:

pnpm --filter nogbase-front test
pnpm --filter nogbase-front type-check
pnpm --filter nogbase-front build
pnpm run storybook
pnpm run storybook:build

Storybook

The canonical Nogbase UI portal is available at:

http://localhost:6010

CRM and platform stories from this package are organized under:

CRM Patterns/*
Platform Shell/Starter Page/Nogbase Engine / Default

Design Boundary

Use this package for reusable engine UI. Do not add app-specific one-off screens to apps/starter.

Good candidates for this package:

• object-record models and UI,
• view picker/filter/sort/group behavior,
• spreadsheet import workflow,
• app shell primitives,
• page layout and widget surfaces,
• front-component management surfaces.

Avoid direct dependencies on generated backend files until a Nogbase adapter exists. Prefer explicit local types and adapter interfaces first, then wire backend clients later.