Merging devt to next

.gitattributes

@@ -0,0 +1,2 @@
+# Mark dist folder as generated code to collapse in GitHub PR diffs
+dist/** linguist-generated=true

.github/workflows/build-and-commit.yml

@@ -0,0 +1,54 @@
+name: Build and Commit Dist
+
+on:
+  push:
+    paths-ignore:
+      - '**.md'
+      - 'README'
+      - 'docs/**'
+
+permissions:
+  contents: write
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Check for NOBUILD in commit message
+        id: check_nobuild
+        run: |
+          COMMIT_MSG=$(git log -1 --pretty=%B)
+          if echo "$COMMIT_MSG" | grep -q "NOBUILD"; then
+            echo "NOBUILD found in commit message. Skipping build."
+            echo "skip=true" >> $GITHUB_OUTPUT
+          else
+            echo "skip=false" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Setup Node.js
+        if: steps.check_nobuild.outputs.skip != 'true'
+        uses: actions/setup-node@v4
+        with:
+          node-version: 'lts/*'
+          cache: 'yarn'
+
+      - name: Install dependencies
+        if: steps.check_nobuild.outputs.skip != 'true'
+        run: yarn install --frozen-lockfile
+
+      - name: Build project
+        if: steps.check_nobuild.outputs.skip != 'true'
+        run: yarn build
+
+      - name: Commit and push dist directory
+        if: steps.check_nobuild.outputs.skip != 'true'
+        run: |
+          git config --global user.name 'github-actions[bot]'
+          git config --global user.email 'github-actions[bot]@users.noreply.github.com'
+          git add dist/
+          git commit -m "Build $(git rev-parse --short HEAD)" || echo "No changes to commit"
+          git push

.gitignore

@@ -28,3 +28,6 @@ dist-ssr
 
 # Licenses / secrets
 kendo-ui-license.txt
+
+# Personal TODOs
+TODO.md

README.md

@@ -1,3 +1,46 @@
 # EWC Client
 
-This is the JavaScript/React client for the [EWC project](https://github.com/dyalog/ewc).
+![EWC-Client Cover](./assets/ewc_client_cover.png)
+
+This is the JavaScript/React client for the [EWC project](https://github.com/dyalog/ewc).
+
+## Getting Started
+
+Clone [ewc](https://github.com/dyalog/ewc) and this repository. It is suggested
+that you place the two repositories next to each other, for example:
+
+    /my/dev/directory/ewc
+    /my/dev/directory/ewc-client
+
+This ensures that when running ewc, it will, by default, pick up the latest
+build from ewc-client automatically.
+
+Follow the [instructions for verifying an ewc installation](https://dyalog.github.io/ewc/0.2/Usage/Installation/).
+
+When working on the JavaScript code, we use [vite](https://vite.dev) for hot
+reloading. To point to EWC on the default websocket port 22322, simply copy
+.env.example:
+
+    cp .env.example .env.development
+
+Then run the vite server:
+
+    vite
+
+For development, it's much easier to run in a browser to use all the tooling.
+In APL, you simply change mode from 'Desktop' to 'Browser':
+
+    demo.Run 'Browser'
+
+Then open http://localhost:5173 (assuming default vite port). By default, this
+will connect a websocket over the :22322 port, as mentioned above.
+
+## Branches
+
+We use three permanent branches in ewc-client.
+
+* `main`: this code has been released.
+* `next`: this will become the next `main`. It should be stable.
+* `devt`: this is unstable and should be considered the 'bleeding edge'.
+
+Contributors should checkout devt, and create PRs against that branch.

eslint.config.js

@@ -0,0 +1,44 @@
+import js from '@eslint/js';
+import globals from 'globals';
+import react from 'eslint-plugin-react';
+import reactHooks from 'eslint-plugin-react-hooks';
+import reactRefresh from 'eslint-plugin-react-refresh';
+
+export default [
+  { ignores: ['dist'] },
+  {
+    files: ['**/*.{js,jsx}'],
+    languageOptions: {
+      ecmaVersion: 'latest',
+      sourceType: 'module',
+      globals: {
+        ...globals.browser,
+      },
+      parserOptions: {
+        ecmaFeatures: {
+          jsx: true,
+        },
+      },
+    },
+    settings: {
+      react: {
+        version: '18.2',
+      },
+    },
+    plugins: {
+      react,
+      'react-hooks': reactHooks,
+      'react-refresh': reactRefresh,
+    },
+    rules: {
+      ...js.configs.recommended.rules,
+      ...react.configs.recommended.rules,
+      ...react.configs['jsx-runtime'].rules,
+      ...reactHooks.configs.recommended.rules,
+      'react-refresh/only-export-components': [
+        'warn',
+        { allowConstantExport: true },
+      ],
+    },
+  },
+];