add ci workflows

Author: Fernando Ledesma

.github/workflows/ci.yml

@@ -0,0 +1,38 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - "**"
+
+jobs:
+  lint-and-build:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        example: [mdk-nextjs-demo]
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+          cache-dependency-path: ${{ matrix.example }}/package-lock.json
+
+      - name: Install dependencies
+        run: npm ci
+        working-directory: ${{ matrix.example }}
+
+      - name: Lint
+        run: npm run lint
+        working-directory: ${{ matrix.example }}
+
+      - name: Build
+        run: npm run build
+        working-directory: ${{ matrix.example }}

.github/workflows/vercel-demo.yml

@@ -0,0 +1,59 @@
+name: Deploy to Vercel
+
+on:
+  workflow_dispatch:
+    inputs:
+      environment:
+        description: "Vercel environment to pull (preview or production)"
+        required: false
+        default: "preview"
+  pull_request:
+    branches:
+      - "**"
+  push:
+    branches:
+      - main
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    env:
+      APP_DIR: mdk-nextjs-demo
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+          cache-dependency-path: ${{ env.APP_DIR }}/package-lock.json
+
+      - name: Install dependencies
+        run: npm ci
+        working-directory: ${{ env.APP_DIR }}
+
+      - name: Lint demo
+        run: npm run lint
+        working-directory: ${{ env.APP_DIR }}
+
+      - name: Build demo
+        run: npm run build
+        working-directory: ${{ env.APP_DIR }}
+
+      - name: Pull Vercel environment settings
+        run: npx vercel pull --yes --environment=${{ inputs.environment || 'preview' }} --token=$VERCEL_TOKEN
+        working-directory: ${{ env.APP_DIR }}
+        env:
+          VERCEL_TOKEN: ${{ secrets.VERCEL_TOKEN }}
+          VERCEL_ORG_ID: ${{ secrets.VERCEL_ORG_ID }}
+          VERCEL_PROJECT_ID: ${{ secrets.VERCEL_PROJECT_ID }}
+
+      - name: Deploy to Vercel
+        run: npx vercel deploy --prod --yes --token=$VERCEL_TOKEN
+        working-directory: ${{ env.APP_DIR }}
+        env:
+          VERCEL_TOKEN: ${{ secrets.VERCEL_TOKEN }}
+          VERCEL_ORG_ID: ${{ secrets.VERCEL_ORG_ID }}
+          VERCEL_PROJECT_ID: ${{ secrets.VERCEL_PROJECT_ID }}

README.md

@@ -0,0 +1,65 @@
+# Money Dev Kit Examples
+
+This repository contains example applications demonstrating how to integrate Money Dev Kit into your projects. These examples use published npm packages and represent real-world usage patterns.
+
+## Examples
+
+### [mdk-nextjs-demo](./mdk-nextjs-demo)
+
+A Next.js application demonstrating the Money Dev Kit checkout flow integration. This example shows:
+- Client-side checkout navigation with `useCheckout` hook
+- Hosted checkout page rendering with `<Checkout />` component
+- Server-side API route setup
+- Next.js configuration with the MDK plugin
+
+**Live Demo:** [https://mdk-nextjs-demo-brown.vercel.app](https://mdk-nextjs-demo-brown.vercel.app)
+
+## Getting Started
+
+Each example is a standalone project with its own dependencies and setup instructions. Navigate to the example directory and follow its README.
+
+```bash
+cd mdk-nextjs-demo
+npm install
+npm run dev
+```
+
+## Requirements
+
+- Node.js 20 or later
+- npm or pnpm
+- Money Dev Kit API credentials (get them at [moneydevkit.com](https://moneydevkit.com) or run `npx @moneydevkit/create`)
+
+## Using Published Packages
+
+All examples in this repository use published versions of Money Dev Kit packages:
+- `@moneydevkit/nextjs` - Next.js integration components
+- `@moneydevkit/core` - Core Lightning functionality
+- `@moneydevkit/create` - CLI for generating credentials
+
+For the latest stable versions:
+```bash
+npm install @moneydevkit/nextjs
+```
+
+For beta releases:
+```bash
+npm install @moneydevkit/nextjs@beta
+```
+
+## Contributing
+
+Want to add a new example? Follow these guidelines:
+1. Each example should be in its own directory at the repository root
+2. Use published npm packages (not local tarballs)
+3. Include a detailed README with setup instructions
+4. Add your example to the CI workflow matrix in [.github/workflows/ci.yml](./.github/workflows/ci.yml)
+5. Ensure the example builds and runs successfully
+
+## Development & Integration Testing
+
+This repository is for **user-facing examples** with published packages. For integration testing with local development builds, see the [mdk-checkout](https://github.com/moneydevkit/mdk-checkout) repository.
+
+## License
+
+MIT