[config][infra] add grafana-react monorepo integration

__Changes__
- Add GitHub workflow for syncing grafana-react to public repo
- Add moon.yml with build, test, lint, and CLI tasks
- Register grafana-react and dashboards project in moon workspace
- Add dashboards project to pnpm workspace
- Add notes documenting OSS sync workflow and schema alignment

__Why__
- Enables automatic sync of oss/grafana-react/pkg to kiwi-research/grafana-react
- Provides moon tasks for building dashboards within the monorepo

Co-Authored-By: Claude <noreply@anthropic.com>

Author: jordangarside

.github/workflows/ci.yml

@@ -16,7 +16,7 @@ jobs:
       - name: Setup pnpm
         uses: pnpm/action-setup@v4
         with:
-          version: 9
+          version: 10
 
       - name: Setup Node.js
         uses: actions/setup-node@v4
@@ -28,8 +28,14 @@ jobs:
       - name: Install dependencies
         run: pnpm install --frozen-lockfile
 
+      - name: Check formatting
+        run: pnpm format:check
+
+      - name: Lint
+        run: pnpm lint
+
       - name: Type check
-        run: pnpm exec tsc --noEmit
+        run: pnpm typecheck
 
       - name: Build
         run: pnpm build

.github/workflows/docs.yml .github/workflows/deploy-docs.yml.github/workflows/docs.yml renamed to .github/workflows/deploy-docs.yml

@@ -0,0 +1,35 @@
+name: Publish to npm
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 9
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Build
+        run: pnpm run build
+
+      - name: Publish
+        run: npm publish --provenance --access public

.github/workflows/npm-publish.yml

@@ -0,0 +1,12 @@
+# Build outputs
+build/
+docs/dist/
+
+# Dependencies
+node_modules/
+
+# Astro
+docs/.astro/
+
+# Generated docs (from source JSDoc)
+docs/src/content/docs/components/_generated/

.gitignore

@@ -0,0 +1,5 @@
+# Prettier respects .gitignore by default
+# This file only needs entries for things to ignore from prettier but keep in git
+
+# Lock files (committed for CI, but don't format)
+pnpm-lock.yaml

.prettierignore

@@ -0,0 +1,33 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.0.1] - 2026-01-09
+
+### Added
+
+- Initial release
+- Core components: `Dashboard`, `Row`, `Variable`, `Annotation`, `Link`, `Query`, `Override`
+- Panel components:
+  - Core: `Stat`, `Timeseries`, `Table`, `BarGauge`, `Heatmap`, `Gauge`, `Text`
+  - Charts: `BarChart`, `PieChart`, `Histogram`, `StateTimeline`, `StatusHistory`, `Candlestick`, `Trend`, `XYChart`
+  - Data display: `Logs`, `Datagrid`
+  - Specialized: `NodeGraph`, `Traces`, `FlameGraph`, `Canvas`, `Geomap`
+  - Widgets: `DashboardList`, `AlertList`, `AnnotationsList`, `News`
+  - Plugins: `PluginPanel`, `BusinessVariablePanel`
+- CLI with `build`, `build-all`, `validate`, and `watch` commands
+- `render()` and `renderToString()` functions for programmatic use
+- Full TypeScript support with comprehensive type exports
+- Automatic panel positioning with row wrapping
+- Threshold normalization (object syntax: `{ 70: 'yellow', 90: 'red' }`)
+- Legend configuration (string shorthand or object)
+- Tooltip configuration
+- Row padding support
+
+[Unreleased]: https://github.com/kiwi-research/grafana-react/compare/v0.0.1...HEAD
+[0.0.1]: https://github.com/kiwi-research/grafana-react/releases/tag/v0.0.1

CHANGELOG.md

@@ -2,6 +2,12 @@
 
 React-based DSL for creating Grafana dashboards. Write dashboards as JSX components and compile them to Grafana JSON.
 
+<p align="center">
+  <img src="docs/public/img/hero-code.svg" alt="JSX code for Stat panel" height="180" />
+  &nbsp;&nbsp;&nbsp;
+  <img src="docs/public/img/hero-grafana-stat-panel.png" alt="Rendered Grafana Stat panel" height="140" />
+</p>
+
 ## Features
 
 - **Declarative JSX Syntax** - Write dashboards using familiar React patterns
@@ -46,10 +52,20 @@ export default function MyDashboard() {
 }
 ```
 
-Build to JSON:
+Build to JSON using the CLI:
 
 ```bash
-grafana-react build my-dashboard.dashboard.tsx output/my-dashboard.json
+grafana-react build my-dashboard.tsx output/my-dashboard.json
+```
+
+Or programmatically with `renderToString`:
+
+```ts
+import React from 'react';
+import { renderToString } from 'grafana-react';
+
+// Use the JSON string directly, e.g. add as a ConfigMap with Pulumi
+const json = renderToString(React.createElement(MyDashboard));
 ```
 
 ## Documentation

README.md

@@ -7,6 +7,7 @@ export default defineConfig({
   integrations: [
     starlight({
       title: 'grafana-react',
+      customCss: ['./src/styles/custom.css'],
       description: 'React DSL for Grafana dashboards',
       social: [
         {
@@ -31,11 +32,17 @@ export default defineConfig({
         {
           label: 'Components',
           items: [
-            { label: 'Structure', link: '/components/structure/' },
-            { label: 'Query', link: '/components/query/' },
+            {
+              label: 'Structure',
+              autogenerate: { directory: 'components/_generated/structure' },
+            },
+            {
+              label: 'Query',
+              autogenerate: { directory: 'components/_generated/query' },
+            },
             {
               label: 'Panels',
-              autogenerate: { directory: 'components/panels' },
+              autogenerate: { directory: 'components/_generated/panels' },
             },
           ],
         },

docs/.gitignore

@@ -3,14 +3,22 @@
   "type": "module",
   "private": true,
   "scripts": {
-    "dev": "astro dev",
-    "start": "astro dev",
-    "build": "astro build",
-    "preview": "astro preview"
+    "generate": "tsx scripts/generate-docs.ts",
+    "dev": "npm run generate && astro dev",
+    "start": "npm run generate && astro dev",
+    "build": "npm run generate && astro build",
+    "preview": "astro preview",
+    "typecheck": "astro check"
   },
   "dependencies": {
     "@astrojs/starlight": "^0.37.2",
     "astro": "^5.16.7",
     "sharp": "^0.34.5"
+  },
+  "devDependencies": {
+    "@astrojs/check": "^0.9.6",
+    "ts-morph": "^24.0.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.7.2"
   }
 }