@bridgeline-digital/hawk-app-cli 0.1.0-dev.20261020202308 → 0.1.0

package/agents/project/vite.md

@@ -1,19 +1,19 @@
-Created from the CLI's `__TEMPLATE__` template (Vite + TypeScript). `npx hawk-app upgrade` keeps it in step.
-
-- `src/useHawkApp.ts` connects to the host once and keeps the context current; build screens on it.
-- Spark's look comes from the Hawk Apps UI kit (`@bridgeline-digital/hawk-app-ui`), imported in `src/main.tsx`:
-  its stylesheet (`/css`: Montserrat, the host's colors and light or dark mode) and its elements (`/elements`).
-  Build screens from them before writing your own: classes `hawk-section` (with `hawk-section-header`,
-  `hawk-section-title`, `hawk-section-subtitle`), `hawk-kpi-row`, `hawk-stack`, `hawk-button` (`is-outlined`,
-  `is-small`), `hawk-notice` (`is-error`, `is-warning`, `is-success`), `hawk-input`, `hawk-select`, `hawk-chip`,
-  `hawk-empty`, `hawk-spinner`, `hawk-muted`; elements `<hawk-kpi label value hint change good-when highlight loading>`,
-  `<hawk-data-table>` (properties `columns`, `rows`, `totals`; attributes `download`, `max-height`, `clickable`;
-  sortable, CSV download), `<hawk-bar-list>` (`items`, `selectable`: `hawk-select` events) and
-  `<hawk-column-chart>` (`columns`). Data goes in as properties, settings as attributes; `src/hawk-elements.d.ts`
-  types them in JSX. Format numbers and dates with `createFormat(context.locale)` from `/elements`. Don't add another
-  font or restyle the kit; your own styles go in `src/styles.css`, using the `--hawk-ui-*` variables.
-- `vite.config.ts` sets `base` from `HAWK_APP_BASE_PATH` (local dev: `/__SLUG__/`) and the dev server to port 3100.
-  Keep both.
-- Develop: `npm run dev`, then open `<HawkSearch>/admin/apps/__SLUG__?devUrl=http://localhost:3100/__SLUG__/` (the app
-  dev mode allows ports 3100-3103).
-- Build output: `dist/` (`npm run app:deploy` builds and deploys it).
+Created from the CLI's `__TEMPLATE__` template (Vite + TypeScript). `npx hawk-app upgrade` keeps it in step.
+
+- `src/useHawkApp.ts` connects to the host once and keeps the context current; build screens on it.
+- Spark's look comes from the Hawk Apps UI kit (`@bridgeline-digital/hawk-app-ui`), imported in `src/main.tsx`:
+  its stylesheet (`/css`: Montserrat, the host's colors and light or dark mode) and its elements (`/elements`).
+  Build screens from them before writing your own: classes `hawk-section` (with `hawk-section-header`,
+  `hawk-section-title`, `hawk-section-subtitle`), `hawk-kpi-row`, `hawk-stack`, `hawk-button` (`is-outlined`,
+  `is-small`), `hawk-notice` (`is-error`, `is-warning`, `is-success`), `hawk-input`, `hawk-select`, `hawk-chip`,
+  `hawk-empty`, `hawk-spinner`, `hawk-muted`; elements `<hawk-kpi label value hint change good-when highlight loading>`,
+  `<hawk-data-table>` (properties `columns`, `rows`, `totals`; attributes `download`, `max-height`, `clickable`;
+  sortable, CSV download), `<hawk-bar-list>` (`items`, `selectable`: `hawk-select` events) and
+  `<hawk-column-chart>` (`columns`). Data goes in as properties, settings as attributes; `src/hawk-elements.d.ts`
+  types them in JSX. Format numbers and dates with `createFormat(context.locale)` from `/elements`. Don't add another
+  font or restyle the kit; your own styles go in `src/styles.css`, using the `--hawk-ui-*` variables.
+- `vite.config.ts` sets `base` from `HAWK_APP_BASE_PATH` (local dev: `/__SLUG__/`) and the dev server to port 3100.
+  Keep both.
+- Develop: `npm run dev`, then open `<HawkSearch>/admin/apps/__SLUG__?devUrl=http://localhost:3100/__SLUG__/` (the app
+  dev mode allows ports 3100-3103).
+- Build output: `dist/` (`npm run app:deploy` builds and deploys it).