Initial commit: isolate @appgram/react to standalone repo

Extracted from monorepo with CI/CD pipeline for npm publishing.
Includes source, demo app, examples, and GitHub Actions workflows
for CI (build + typecheck) and npm publish on version tags.

Fixed DTS build errors: replaced NodeJS.Timeout with ReturnType<typeof setInterval>
and coerced null fingerprint to undefined.

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

Author: nedimf

.github/workflows/ci.yml

@@ -0,0 +1,33 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [18, 20]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: npm
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Build
+        run: npm run build
+
+      - name: Typecheck
+        run: npm run typecheck

.github/workflows/publish.yml

@@ -0,0 +1,35 @@
+name: Publish to npm
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+          registry-url: https://registry.npmjs.org
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Build
+        run: npm run build
+
+      - name: Publish
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.gitignore

@@ -0,0 +1,48 @@
+# Dependencies
+node_modules
+.pnp
+.pnp.js
+
+# Build
+dist
+dist-ssr
+*.local
+
+# Generated docs
+docs.json
+react-sdk.json
+
+# Environment
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# Logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+# Editor
+.vscode
+.idea
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Testing
+coverage
+
+# TypeScript
+*.tsbuildinfo
+
+# Misc
+*.pem

.npmrc

@@ -0,0 +1 @@
+//registry.npmjs.org/:_authToken=${NPM_TOKEN}

demo/README.md

@@ -0,0 +1,69 @@
+# @appgram/react Demo
+
+Interactive demo app for testing the `@appgram/react` library.
+
+## Quick Start
+
+From the `packages/appgram-react` directory:
+
+```bash
+# Option 1: Full setup (builds library + installs demo + runs)
+npm run demo
+
+# Option 2: Step by step
+npm install          # Install library dependencies
+npm run build        # Build the library
+cd demo
+npm install          # Install demo dependencies
+npm run dev          # Start demo at http://localhost:5173
+```
+
+## Configuration
+
+Edit `demo/src/App.tsx` to update the config:
+
+```tsx
+const CONFIG = {
+  projectId: 'your_project_id',  // Your Appgram project ID
+  orgSlug: 'your_org',           // Your organization slug
+  projectSlug: 'your_project',   // Your project slug
+  // apiUrl: 'http://localhost:3000', // For local API testing
+}
+```
+
+## What's Included
+
+The demo showcases:
+
+1. **Components Tab** - Pre-built `WishList` with search, filters, and click handling
+2. **Hooks Tab** - Custom UI built with `useWishes` and `useVote` hooks
+3. **Roadmap Tab** - `RoadmapBoard` component in kanban layout
+4. **Releases Tab** - `ReleaseList` component in timeline layout
+5. **Help Tab** - `HelpCollections` component with search
+6. **Support Tab** - `SupportForm` for ticket submission
+
+## Development
+
+To develop the library and see changes in the demo:
+
+**Terminal 1** (library watch mode):
+```bash
+cd packages/appgram-react
+npm run dev
+```
+
+**Terminal 2** (demo dev server):
+```bash
+cd packages/appgram-react/demo
+npm run dev
+```
+
+Changes to library files will trigger a rebuild, and Vite will hot-reload the demo.
+
+## Testing with Mock Data
+
+If you don't have an Appgram project, the components will show loading states and then empty/error states. To test the UI:
+
+1. Set up a local Appgram API server
+2. Update `CONFIG.apiUrl` to point to your local server
+3. Or create a test project at appgram.dev

demo/index.html

@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>@appgram/react Demo</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>