@corva/create-app 0.0.0-2576df8

package/templates/stream_time/javascript/README.md

@@ -0,0 +1,19 @@
+# Dev Center Node.js Real-Time Stream Data App
+
+## Getting started
+
+### 1. Install Dependencies
+
+```
+npm install
+```
+
+### 2. Run Tests
+
+```
+npm test
+```
+
+### 3. Deploy
+
+Run `npm run bundle` to create a zip package that can be uploaded to Dev Center

package/templates/stream_time/javascript/__tests__/processor.spec.js

@@ -0,0 +1,14 @@
+const { StreamTimeEvent, StreamTimeRecord } = require('@corva/node-sdk');
+const { app_runner } = require('@corva/node-sdk/testing');
+
+const { processor } = require('..');
+
+test('processes event', async () => {
+  const event = new StreamTimeEvent({
+    company_id: 1,
+    asset_id: 1234,
+    records: [new StreamTimeRecord({ data: { bit_depth: 4980, hole_depth: 5000 }, timestamp: 1620905165 })],
+  });
+
+  expect(await app_runner(processor, event)).toBeUndefined();
+});

package/templates/stream_time/javascript/index.js

@@ -0,0 +1,14 @@
+const { Corva } = require('@corva/node-sdk');
+
+/**
+ * @param {import('@corva/node-sdk').StreamTimeEvent} event
+ * @param {import('@corva/node-sdk').StatefulContext} context
+ */
+const processor = async (event, context) => {
+  // Insert your logic here
+  context.logger.info('Hello, World!');
+};
+
+exports.processor = processor;
+
+exports.handler = new Corva().stream(processor);

package/templates/stream_time/python/README.md

@@ -0,0 +1,31 @@
+# Dev Center Python Real-Time Stream Data App
+
+## Getting started
+
+[Python SDK Documentation](https://corva-ai.github.io/python-sdk)
+
+### 1. Install
+
+You need to have `make` installed:
+
+- Windows: [Windows Subsystem for Linux](https://docs.microsoft.com/en-us/windows/wsl/install)
+- OS X: [Command Line Tools for Xcode](https://developer.apple.com/download/more/)
+- Linux: refer to your distro-specific docs
+
+To install dependencies run:
+
+```sh
+make
+```
+
+### 2. Run Tests
+
+```sh
+make test
+```
+
+### 3. Create app zip
+
+```sh
+make bundle
+```

package/templates/stream_time/python/lambda_function.py

@@ -0,0 +1,7 @@
+from corva import Api, Cache, Logger, StreamTimeEvent, stream
+
+
+@stream
+def lambda_handler(event: StreamTimeEvent, api: Api, cache: Cache):
+    """Insert your logic here"""
+    Logger.info('Hello, World!')

package/templates/stream_time/python/test/app_test.py

@@ -0,0 +1,16 @@
+from corva import StreamTimeEvent, StreamTimeRecord
+from lambda_function import lambda_handler
+
+
+def test_app(app_runner):
+    event = StreamTimeEvent(
+        company_id=1,
+        asset_id=1234,
+        records=[
+            StreamTimeRecord(
+                data={'bit_depth': 4980, 'hole_depth': 5000}, timestamp=1620905165
+            )
+        ],
+    )
+
+    app_runner(lambda_handler, event=event)

package/templates/stream_time/typescript/README.md

@@ -0,0 +1,25 @@
+# Dev Center Node.js TypeScript Real-Time Stream Data App
+
+## Getting started
+
+### 1. Install Dependencies
+
+```
+npm install
+```
+
+### 2. Run Tests
+
+```
+npm test
+```
+
+### 3. Build
+
+```
+npm run build
+```
+
+### 4. Deploy
+
+Run `npm run bundle` to create a zip package that can be uploaded to Dev Center

package/templates/stream_time/typescript/__tests__/processor.spec.ts

@@ -0,0 +1,14 @@
+import { app_runner } from '@corva/node-sdk/testing';
+import { StreamTimeEvent, StreamTimeRecord } from '@corva/node-sdk';
+
+import { processor } from '..';
+
+test('processes event', async () => {
+  const event = new StreamTimeEvent({
+    company_id: 1,
+    asset_id: 1234,
+    records: [new StreamTimeRecord({ data: { bit_depth: 4980, hole_depth: 5000 }, timestamp: 1620905165 })],
+  });
+
+  expect(await app_runner(processor, event)).toBeUndefined();
+});

package/templates/stream_time/typescript/index.ts

@@ -0,0 +1,8 @@
+import { Corva, StatefulContext, StreamTimeEvent } from '@corva/node-sdk';
+
+export const processor = async (event: StreamTimeEvent, context: StatefulContext) => {
+  // Insert your logic here
+  context.logger.info('Hello, World!');
+};
+
+export const handler = new Corva().stream(processor);

package/templates/task/javascript/README.md

@@ -0,0 +1,19 @@
+# Dev Center Node.js Task Data App
+
+## Getting started
+
+### 1. Install Dependencies
+
+```
+npm install
+```
+
+### 2. Run Tests
+
+```
+npm test
+```
+
+### 3. Deploy
+
+Run `npm run bundle` to create a zip package that can be uploaded to Dev Center

package/templates/task/javascript/__tests__/processor.spec.js

@@ -0,0 +1,16 @@
+const { TaskEvent } = require('@corva/node-sdk');
+const { app_runner } = require('@corva/node-sdk/testing');
+
+const { processor } = require('..');
+
+test('processes event', async () => {
+  const event = new TaskEvent({
+    company_id: 1,
+    asset_id: 1234,
+    properties: {
+      foo: 'bar',
+    },
+  });
+
+  expect(await app_runner(processor, event)).toBeUndefined();
+});

package/templates/task/javascript/index.js

@@ -0,0 +1,15 @@
+const { Corva } = require('@corva/node-sdk');
+
+/**
+ *
+ * @param {import('@corva/node-sdk').TaskEvent} event
+ * @param {import('@corva/node-sdk').StatelessContext} context
+ */
+const processor = async (event, context) => {
+  // Insert your logic here
+  context.logger.info('Hello, World!');
+};
+
+exports.processor = processor;
+
+exports.handler = new Corva().task(processor);

package/templates/task/python/README.md

@@ -0,0 +1,31 @@
+# Dev Center Python Task Data App
+
+## Getting started
+
+[Python SDK Documentation](https://corva-ai.github.io/python-sdk)
+
+### 1. Install
+
+You need to have `make` installed:
+
+- Windows: [Windows Subsystem for Linux](https://docs.microsoft.com/en-us/windows/wsl/install)
+- OS X: [Command Line Tools for Xcode](https://developer.apple.com/download/more/)
+- Linux: refer to your distro-specific docs
+
+To install dependencies run:
+
+```sh
+make
+```
+
+### 2. Run Tests
+
+```sh
+make test
+```
+
+### 3. Create app zip
+
+```sh
+make bundle
+```

package/templates/task/python/lambda_function.py

@@ -0,0 +1,7 @@
+from corva import Api, Logger, TaskEvent, task
+
+
+@task
+def lambda_handler(event: TaskEvent, api: Api):
+    """Insert your logic here"""
+    Logger.info('Hello, World!')

package/templates/task/python/test/app_test.py

@@ -0,0 +1,8 @@
+from corva import TaskEvent
+from lambda_function import lambda_handler
+
+
+def test_app(app_runner):
+    event = TaskEvent(company_id=1, asset_id=1234, properties={'foo': "bar"})
+
+    app_runner(lambda_handler, event=event)

package/templates/task/typescript/README.md

@@ -0,0 +1,25 @@
+# Dev Center Node.js Task Data App
+
+## Getting started
+
+### 1. Install Dependencies
+
+```
+npm install
+```
+
+### 2. Run Tests
+
+```
+npm test
+```
+
+### 3. Build
+
+```
+npm run build
+```
+
+### 4. Deploy
+
+Run `npm run bundle` to create a zip package that can be uploaded to Dev Center

package/templates/task/typescript/__tests__/processor.spec.ts

@@ -0,0 +1,16 @@
+import { app_runner } from '@corva/node-sdk/testing';
+import { TaskEvent } from '@corva/node-sdk';
+
+import { processor } from '..';
+
+test('processes event', async () => {
+  const event = new TaskEvent({
+    company_id: 1,
+    asset_id: 1234,
+    properties: {
+      foo: 'bar',
+    },
+  });
+
+  expect(await app_runner(processor, event)).toBeUndefined();
+});

package/templates/task/typescript/index.ts

@@ -0,0 +1,8 @@
+import { Corva, StatelessContext, TaskEvent } from '@corva/node-sdk';
+
+export const processor = async (event: TaskEvent, context: StatelessContext) => {
+  // Insert your logic here
+  context.logger.info('Hello, World!');
+};
+
+export const handler = new Corva().task(processor);

package/templates/ui/javascript/.codex/config.toml

@@ -0,0 +1,3 @@
+[mcp_servers.corva-ui]
+command = "npx"
+args = ["-p", "@corva/ui", "corva-ui-mcp"]

package/templates/ui/javascript/.cursor/mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "corva-ui": {
+      "command": "npx",
+      "args": ["-p", "@corva/ui", "corva-ui-mcp"]
+    }
+  }
+}

package/templates/ui/javascript/.eslintrc

@@ -0,0 +1,11 @@
+{
+  "root": true,
+  "extends": "@corva/eslint-config-browser",
+  "parserOptions": {
+    "requireConfigFile": false,
+    "babelOptions": {
+      "presets": ["@babel/preset-react"],
+      "plugins": ["@babel/plugin-proposal-class-properties"]
+    }
+  }
+}

package/templates/ui/javascript/.mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "corva-ui": {
+      "command": "npx",
+      "args": ["-p", "@corva/ui", "corva-ui-mcp"]
+    }
+  }
+}

package/templates/ui/javascript/.prettierrc

@@ -0,0 +1 @@
+"@corva/eslint-config-browser/prettier"

package/templates/ui/javascript/AGENTS.md

@@ -0,0 +1,304 @@
+# AGENTS.md
+
+Corva.AI platform UI app — a React dashboard widget scaffolded by `create-corva-app`.
+Deployed to the Corva platform via `yarn release`.
+
+## Critical Rules
+
+These constraints are enforced by the platform. Violating them breaks the build or runtime.
+
+1. **Root export** — `src/index.js` MUST default-export `{ component: App, settings: AppSettings }`. The component may also be a `ParentApp` wrapper (e.g., `{ component: ParentApp, settings: AppSettings }`) that wraps `App` with Context.Providers and prop initialization. This is the platform loader contract.
+2. **UI components** — Use only `@corva/ui` components. Import from `@corva/ui/componentsV2`; fall back to `@corva/ui/components` only when a V2 version doesn't exist yet. `@material-ui/core` v4 is available as the underlying library.
+3. **HTTP clients** — Use `corvaDataAPI` / `corvaAPI` from `@corva/ui/clients` for all network requests.
+4. **Do not rename or delete** `App.js`, `AppSettings.js`, or `index.js` — they are platform entry points.
+
+## Project Structure
+
+```
+src/
+  App.js               — Main app component (default export required)
+  AppSettings.js       — Settings panel component (default export required)
+  index.js             — Root export: { component, settings }
+  constants.js         — Default settings values
+  App.scss              — Component styles
+  __tests__/           — Jest test files
+  __mocks__/           — Mock data (mockAppProps.js, mockAppSettingsProps.js)
+  assets/              — Static assets (SVGs, images)
+config/jest/           — Jest setup (setupTests, transforms)
+config-overrides.js    — Webpack 5 customization
+manifest.json          — Corva platform app metadata (generated at scaffold time)
+```
+
+## Key Patterns
+
+### Component Structure
+
+- Use JSDoc `@param` / `@returns` annotations for prop documentation.
+- Use `useAppCommons()` from `@corva/ui/effects` for app context (`appKey`).
+
+### Styling
+
+The preferred way to write styles is SCSS (`.scss` files).
+
+Every `.scss` file must import the shared utilities:
+
+```scss
+@import '@corva/ui/styles/common';
+```
+
+This provides all functions, variables, and mixins below.
+
+For custom shared variables or mixins specific to the project, create a `src/styles/` directory (e.g. `_variables.scss`, `_common.scss`) and import them alongside the `@corva/ui` import.
+
+**`spacing($top, $right?, $bottom?, $left?)`** — 8px base unit:
+
+```scss
+padding: spacing(2); // 16px
+margin: spacing(1, 0); // 8px 0
+gap: spacing(0.5); // 4px
+padding: spacing(2, 1, 2, 1); // 16px 8px 16px 8px
+```
+
+**`colorAlpha($color, $opacity)`** — transparency:
+
+```scss
+background: colorAlpha($palette_t1, 0.08); // white at 8% opacity
+border: 1px solid colorAlpha($palette_t1, 0.12);
+```
+
+**`transition($properties...)`** — standard `cubic-bezier(0.4, 0, 0.2, 1) 0.15s`:
+
+```scss
+transition: transition(opacity);
+transition: transition(color, background-color);
+```
+
+**Full example:**
+
+```scss
+@import '@corva/ui/styles/common';
+
+.container {
+  padding: spacing(2);
+  background: $palette_b5;
+  color: $palette_t1;
+  transition: transition(opacity, background-color);
+
+  &:hover {
+    background: colorAlpha($palette_t1, 0.08);
+  }
+}
+
+.label {
+  color: $palette_t7;
+  font-size: 12px;
+}
+```
+
+**Import in component:**
+
+```javascript
+import styles from './App.scss';
+// Use: <div className={styles.container}>
+```
+
+**Colors & Theming:**
+
+NEVER hardcode color values (hex, rgb, hsl). Always use `@corva/ui` theme colors:
+
+- In SCSS: use SCSS variables from `@corva/ui/styles/common` like `$palette_t1`, `$palette_b5`, `$palette_t7`
+- Use `colorAlpha($color, $opacity)` for transparency instead of raw `rgba()`
+- Run MCP tool `get_theme_docs` (section: "variables") to see all available theme variables
+- Run MCP tool `get_theme_docs` (section: "palette") to see available palette colors with hex values
+
+**Rules:**
+
+- No inline `style={{...}}` unless absolutely necessary for dynamic values
+- Use `classnames` for conditional/composed classes, never manual string joins
+- No global selectors (tag selectors like `div`, `span`) — use `:global()` only when absolutely necessary
+- No `!important`
+- Use a descriptive camelCase class as the root selector (e.g. `.toolbar`, `.chartPanel`) instead of generic `.root`
+
+### State Management (Zustand)
+
+The Corva platform can render multiple instances of the same app simultaneously. If a Zustand store is created at module level (singleton), all instances share the same state. To avoid this, always create store instances inside a React Context provider.
+
+**Store factory + context** — create a factory function and a context to hold the store instance:
+
+```javascript
+// store/createAppStore.js
+import { createContext } from 'react';
+import { create } from 'zustand';
+
+export const createAppStore = (initProps = {}) => {
+  return create((set, get) => ({
+    // Compose sub-stores
+    ...createSettingsStore(initProps.settings)(set, get),
+    ...createDataStore()(set, get),
+  }));
+};
+
+export const StoreContext = createContext(null);
+```
+
+**Provider** — create the store once per app mount and pass it via context:
+
+```javascript
+// StoreProvider.js
+import { useState } from 'react';
+
+import { StoreContext, createAppStore } from './store/createAppStore';
+
+export const StoreProvider = ({ children, savedSettings }) => {
+  const [appStore] = useState(() => createAppStore(savedSettings));
+
+  return <StoreContext.Provider value={appStore}>{children}</StoreContext.Provider>;
+};
+```
+
+**Consumer hooks** — read from context, never from a global store:
+
+```javascript
+// hooks/useAppStore.js
+import { useContext } from 'react';
+import { useStore } from 'zustand';
+import { useStoreWithEqualityFn } from 'zustand/traditional';
+
+import { StoreContext } from '../store/createAppStore';
+
+/** Read a single top-level key from the store. */
+export const useAppStore = key => {
+  const store = useContext(StoreContext);
+  if (!store) throw new Error('useAppStore must be used within StoreProvider');
+  return useStore(store, state => state[key]);
+};
+
+/** Subscribe to a derived value with optional custom equality. */
+export const useAppStoreSelector = (selector, equalityFn) => {
+  const store = useContext(StoreContext);
+  if (!store) throw new Error('useAppStoreSelector must be used within StoreProvider');
+  return useStoreWithEqualityFn(store, selector, equalityFn);
+};
+```
+
+**Usage in components:**
+
+```javascript
+const isLegendVisible = useAppStore('isLegendVisible');
+const selectedChannels = useAppStoreSelector(state => state.selectedChannels);
+```
+
+**Wire it up in `ParentApp`** (see full example with `QueryClientProvider` in the Data Fetching section below).
+
+General rules:
+
+- Name stores `use[Name]Store` (e.g., `useWellDataStore`)
+- Use selectors: `const value = useAppStore('value')`
+- Keep business logic in store actions
+
+### Data Fetching (React Query v4)
+
+Same as Zustand: the platform runs multiple app instances, so each must have its own `QueryClient`. Never create a `QueryClient` at module level — use a hook with `useState` to create it once per mount.
+
+**`useQueryClient` hook** — creates an isolated `QueryClient` per app instance:
+
+```javascript
+// hooks/useQueryClient.js
+import { useState } from 'react';
+import { QueryCache, QueryClient } from '@tanstack/react-query';
+import { showErrorNotification } from '@corva/ui/utils';
+
+export const useQueryClient = () => {
+  const [queryClient] = useState(
+    new QueryClient({
+      queryCache: new QueryCache({
+        onError: error => {
+          if (error?.message) {
+            showErrorNotification(`Something went wrong: ${error.message}`);
+          }
+        },
+      }),
+      defaultOptions: {
+        queries: {
+          refetchOnWindowFocus: false,
+          refetchOnReconnect: false,
+        },
+      },
+    })
+  );
+
+  return queryClient;
+};
+```
+
+**Wire it up in `ParentApp`** — wrap the app tree with `QueryClientProvider`:
+
+```javascript
+import { QueryClientProvider } from '@tanstack/react-query';
+
+const ParentApp = () => {
+  const { appSettings, onSettingsChange } = useAppCommons();
+  const queryClient = useQueryClient();
+
+  return (
+    <QueryClientProvider client={queryClient}>
+      <StoreProvider savedSettings={appSettings?.savedSettings}>
+        <App />
+      </StoreProvider>
+    </QueryClientProvider>
+  );
+};
+
+export default { component: ParentApp, settings: AppSettings };
+```
+
+General rules:
+
+- Encapsulate queries in custom hooks (e.g., `useWellData`)
+- Use typed query keys (array format)
+- Always handle `isLoading` and `isError` states
+
+## Naming Conventions
+
+- Boolean variables: prefix with `is`, `has`, or `should`
+- Non-empty array checks: `!!array.length` (not `array.length > 0`)
+
+## Testing
+
+- **Framework:** Jest + React Testing Library
+- **Wrapper:** Use `AppTestWrapper` from `@corva/ui/testing` to wrap components
+- **Mocking:** Mock network requests (jest mocks or msw), never call real APIs
+- **Timezone:** UTC is enforced (`process.env.TZ = 'UTC'`)
+- **Mocked globals:** `ResizeObserver`, `MutationObserver` (in `setupTests.js`)
+
+## Commands
+
+```
+yarn start     Dev server at http://app.local.corva.ai:8080/
+yarn build     Production bundle
+yarn test      Run tests
+yarn lint      ESLint check
+yarn zip       Create deployment ZIP
+yarn release   Release to Corva platform
+```
+
+## @corva/ui Documentation
+
+Local documentation for `@corva/ui` is bundled at `node_modules/@corva/ui/docs/`.
+Before implementing any UI component, data fetch, or API call, read the relevant doc file:
+
+- **V2 Components:** `node_modules/@corva/ui/docs/01-components-v2/` — Props, examples, usage
+- **V1 Components:** `node_modules/@corva/ui/docs/02-components-v1/` — Legacy components reference
+- **Hooks:** `node_modules/@corva/ui/docs/03-hooks/` — Parameters, return types, examples
+- **API Clients:** `node_modules/@corva/ui/docs/04-clients/` — corvaAPI, corvaDataAPI endpoints
+- **Theme:** `node_modules/@corva/ui/docs/05-theme/` — Color palette, CSS variables
+- **Utilities:** `node_modules/@corva/ui/docs/06-utilities/` — Helper functions
+- **Constants:** `node_modules/@corva/ui/docs/07-constants/` — Platform constants
+
+Start with `node_modules/@corva/ui/docs/README.md` for the full index.
+Do NOT guess `@corva/ui` APIs — read the local docs first.
+
+## MCP Server (Interactive Fallback)
+
+The `corva-ui` MCP server is pre-configured (`.mcp.json`, `.cursor/mcp.json`, `.codex/config.toml`).
+Use it for interactive queries when the local docs are insufficient or you need to search across components.

package/templates/ui/javascript/CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md