Add CI for submitting plugins to Marketplace on merge

.github/pull_request_template.md

@@ -4,6 +4,12 @@
 
 This pull request …
 
+### Changelog
+
+<!-- Required when using the "Submit on merge" label. Describe user-facing changes in bullet points. -->
+
+-
+
 ### Testing
 
 <!-- List of steps to verify the code this pull request changed. If it is a Plugin additions, what are the core workflows to test. If it is a bug fix, what are the steps to verify it is fixed -->

.github/workflows/ci.yml

@@ -93,38 +93,38 @@ jobs:
               uses: tj-actions/changed-files@v45
               with:
                   files: |
-                      plugins/*/src/**
-                      plugins/*/test/**
-                      plugins/*/*.test.ts
-                      plugins/*/*.test.tsx
-                      plugins/*/vitest.config.ts
-                      plugins/*/test-setup.ts
+                      {plugins,packages}/*/src/**
+                      {plugins,packages}/*/test/**
+                      {plugins,packages}/*/*.test.ts
+                      {plugins,packages}/*/*.test.tsx
+                      {plugins,packages}/*/vitest.config.ts
+                      {plugins,packages}/*/test-setup.ts
 
             - name: Install dependencies
               if: steps.changed-files.outputs.any_changed == 'true'
               run: yarn
 
-            - name: Get changed plugins
+            - name: Get changed workspaces
               if: steps.changed-files.outputs.any_changed == 'true'
-              id: changed-plugins
+              id: changed-workspaces
               run: |
-                # Extract unique plugin names from changed files
-                PLUGINS=$(echo "${{ steps.changed-files.outputs.all_changed_files }}" | \
-                  grep -E '^plugins/[^/]+/' | \
-                  cut -d'/' -f2 | \
+                # Extract unique workspace paths from changed files
+                WORKSPACES=$(echo "${{ steps.changed-files.outputs.all_changed_files }}" | \
+                  grep -oE '(plugins|packages)/[^/]+' | \
                   sort -u | \
                   tr '\n' ' ')
-                echo "plugins=$PLUGINS" >> $GITHUB_OUTPUT
-                echo "Changed plugins: $PLUGINS"
+                echo "workspaces=$WORKSPACES" >> $GITHUB_OUTPUT
+                echo "Changed workspaces: $WORKSPACES"
 
-            - name: Run tests for changed plugins
-              if: steps.changed-files.outputs.any_changed == 'true' && steps.changed-plugins.outputs.plugins != ''
+            - name: Run tests for changed workspaces
+              if: steps.changed-files.outputs.any_changed == 'true' && steps.changed-workspaces.outputs.workspaces != ''
               run: |
-                for plugin in ${{ steps.changed-plugins.outputs.plugins }}; do
-                  echo "Checking tests for plugin: $plugin"
-                  if [ -f "plugins/$plugin/package.json" ] && grep -q '"check-vitest"' "plugins/$plugin/package.json"; then
-                    yarn workspace $plugin check-vitest
+                for workspace in ${{ steps.changed-workspaces.outputs.workspaces }}; do
+                  echo "Checking tests for workspace: $workspace"
+                  if [ -f "$workspace/package.json" ] && grep -q '"check-vitest"' "$workspace/package.json"; then
+                    name=$(jq -r '.name' "$workspace/package.json")
+                    yarn workspace "$name" check-vitest
                   else
-                    echo "No check-vitest script found for $plugin, skipping..."
+                    echo "No check-vitest script found for $workspace, skipping..."
                   fi
                 done

.github/workflows/shippy.yml

@@ -7,6 +7,8 @@ on:
       - edited
       - ready_for_review
       - synchronize
+      - labeled
+      - unlabeled
   workflow_dispatch:
     # NOTE: To prevent GitHub from adding PRs to the merge queue before check is done,
     # make sure that there is a ruleset that requires the “Shippy check to pass.
@@ -24,11 +26,32 @@ jobs:
     runs-on: ubuntu-latest
     if: github.event.pull_request.draft == false && github.event.pull_request.user.login != 'dependabot[bot]'
     steps:
-      - name: Check PR description
+      - name: Check if Submit on merge label is present
+        id: check-label
         uses: actions/github-script@v7
         with:
           script: |
-            const prBody = context.payload.pull_request.body?.trim()
-            if (!prBody) {
-              core.setFailed("❌ PR description is required.")
-            }
+            const labels = context.payload.pull_request.labels || []
+            const hasSubmitLabel = labels.some(label => label.name === 'Submit on merge')
+            core.setOutput('require_changelog', hasSubmitLabel ? 'true' : 'false')
+
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          sparse-checkout: |
+            scripts
+            package.json
+            yarn.lock
+            .yarnrc.yml
+            .yarn
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version-file: .tool-versions
+
+      - name: Validate PR body
+        run: yarn dlx tsx scripts/validate-pr-body.ts
+        env:
+          PR_BODY: ${{ github.event.pull_request.body }}
+          REQUIRE_CHANGELOG: ${{ steps.check-label.outputs.require_changelog }}

.github/workflows/submit-on-merge.yml

@@ -0,0 +1,64 @@
+name: Submit on Merge
+
+on:
+  pull_request:
+    types:
+      - closed
+    branches:
+      - main
+
+jobs:
+  submit:
+    name: Submit Changed Plugins
+    runs-on: ubuntu-latest
+    # Only run if PR was merged (not just closed) and has "Submit on merge" label
+    if: |
+      github.event.pull_request.merged == true &&
+      contains(github.event.pull_request.labels.*.name, 'Submit on merge')
+    # FIXME: Should be production
+    environment: development
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # Full history for git tags and diff
+
+      - name: Configure git identity
+        run: |
+          git config --global user.email "marketplace@framer.team"
+          git config --global user.name "Framer Marketplace"
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version-file: .tool-versions
+
+      - name: Install dependencies
+        run: yarn install
+
+      - name: Build framer-plugin-tools
+        working-directory: packages/plugin-tools
+        run: yarn build
+
+      - name: Write PR body to file
+        run: cat <<< "$PR_BODY" > /tmp/pr-body.txt
+        env:
+          PR_BODY: ${{ github.event.pull_request.body }}
+
+      - name: Submit changed plugins
+        run: |
+          export CHANGED_FILES=$(git diff --name-only ${{ github.event.pull_request.base.sha }} ${{ github.event.pull_request.head.sha }})
+          yarn tsx scripts/submit-on-merge.ts
+        env:
+          DEBUG: "1"
+          PR_BODY_FILE: /tmp/pr-body.txt
+          SESSION_TOKEN: ${{ secrets.SESSION_TOKEN }}
+          FRAMER_ADMIN_SECRET: ${{ secrets.FRAMER_ADMIN_SECRET }}
+          SLACK_WEBHOOK_URL: ${{ secrets.SLACK_WEBHOOK_URL }}
+          SLACK_ERROR_WEBHOOK_URL: ${{ secrets.SLACK_ERROR_WEBHOOK_URL }}
+          RETOOL_URL: ${{ secrets.RETOOL_URL }}
+          # FIXME: Should be production
+          FRAMER_ENV: development
+          GITHUB_RUN_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/submit-plugin.yml

@@ -0,0 +1,124 @@
+name: Submit Plugin
+
+on:
+  # Manual trigger from GitHub UI
+  workflow_dispatch:
+    inputs:
+      plugin_path:
+        description: 'Plugin directory (e.g., plugins/csv-import)'
+        required: true
+        type: string
+      changelog:
+        description: 'Changelog for this release'
+        required: true
+        type: string
+      environment:
+        description: 'Environment (development/production)'
+        required: true
+        default: 'development'
+        type: choice
+        options:
+          - development
+          - production
+      dry_run:
+        description: 'Dry run (skip submission and tagging)'
+        required: false
+        default: false
+        type: boolean
+
+  # Reusable workflow - can be called from other repos (e.g., framer/workshop)
+  workflow_call:
+    inputs:
+      plugin_path:
+        description: 'Plugin directory (e.g., plugins/csv-import)'
+        required: true
+        type: string
+      changelog:
+        description: 'Changelog for this release'
+        required: true
+        type: string
+      environment:
+        description: 'Environment (development/production)'
+        required: true
+        default: 'development'
+        type: string
+      dry_run:
+        description: 'Dry run (skip submission and tagging)'
+        required: false
+        default: false
+        type: boolean
+    secrets:
+      SESSION_TOKEN:
+        description: 'Framer session cookie'
+        required: true
+      FRAMER_ADMIN_SECRET:
+        description: 'Framer admin API key'
+        required: true
+      SLACK_WEBHOOK_URL:
+        description: 'Slack webhook URL for notifications'
+        required: false
+      RETOOL_URL:
+        description: 'Retool dashboard URL for Slack notifications'
+        required: false
+      SLACK_ERROR_WEBHOOK_URL:
+        description: 'Slack webhook URL for error notifications'
+        required: false
+
+jobs:
+  submit:
+    name: Submit Plugin to Marketplace
+    runs-on: ubuntu-latest
+    environment: ${{ inputs.environment }}
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # Full history for git tags and diff
+
+      - name: Configure git identity
+        run: |
+          git config --global user.email "marketplace@framer.team"
+          git config --global user.name "Framer Marketplace"
+
+      - name: Validate plugin path
+        run: |
+          if [ ! -d "${{ github.workspace }}/${{ inputs.plugin_path }}" ]; then
+            echo "Error: Plugin path '${{ inputs.plugin_path }}' does not exist"
+            echo ""
+            echo "Available plugins:"
+            ls -1 plugins/
+            exit 1
+          fi
+          if [ ! -f "${{ github.workspace }}/${{ inputs.plugin_path }}/framer.json" ]; then
+            echo "Error: No framer.json found in '${{ inputs.plugin_path }}'"
+            exit 1
+          fi
+          echo "Plugin path validated: ${{ inputs.plugin_path }}"
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version-file: .tool-versions
+
+      - name: Install dependencies
+        run: yarn install
+
+      - name: Build framer-plugin-tools
+        run: yarn turbo run build --filter=framer-plugin-tools
+
+      - name: Submit plugin
+        run: yarn tsx scripts/submit-plugin.ts
+        env:
+          PLUGIN_PATH: ${{ github.workspace }}/${{ inputs.plugin_path }}
+          REPO_ROOT: ${{ github.workspace }}
+          CHANGELOG: ${{ inputs.changelog }}
+          SESSION_TOKEN: ${{ secrets.SESSION_TOKEN }}
+          FRAMER_ADMIN_SECRET: ${{ secrets.FRAMER_ADMIN_SECRET }}
+          SLACK_WEBHOOK_URL: ${{ secrets.SLACK_WEBHOOK_URL }}
+          SLACK_ERROR_WEBHOOK_URL: ${{ secrets.SLACK_ERROR_WEBHOOK_URL }}
+          RETOOL_URL: ${{ secrets.RETOOL_URL }}
+          FRAMER_ENV: ${{ inputs.environment }}
+          GITHUB_RUN_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
+          DRY_RUN: ${{ inputs.dry_run }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package.json

@@ -9,6 +9,7 @@
         "plugins/*"
     ],
     "scripts": {
+        "test:scripts": "vitest run scripts/",
         "check": "turbo run --continue check-biome check-eslint check-prettier check-svelte check-typescript check-vitest",
         "dev": "turbo run dev --concurrency=40",
         "fix-biome": "turbo run --continue check-biome -- --write",
@@ -22,16 +23,22 @@
         "g:dev": "cd $INIT_CWD && run g:vite",
         "g:preview": "cd $INIT_CWD && run g:vite preview",
         "g:vite": "cd $INIT_CWD && NODE_OPTIONS='--no-warnings=ExperimentalWarning' vite --config ${VITE_CONFIG_PATH:-$PROJECT_CWD/packages/vite-config/src/index.ts}",
+        "g:pack": "cd $INIT_CWD && framer-plugin-tools pack",
         "preview": "turbo run preview --concurrency=40"
     },
     "devDependencies": {
         "@biomejs/biome": "^2.2.4",
         "@framer/eslint-config": "workspace:*",
         "@framer/vite-config": "workspace:*",
+        "@types/node": "^22.15.21",
         "eslint": "^9.35.0",
+        "framer-plugin-tools": "workspace:*",
         "jiti": "^2.5.1",
+        "tsx": "^4.19.0",
         "turbo": "^2.5.6",
         "typescript": "^5.9.2",
-        "vite": "^7.1.11"
+        "valibot": "^1.2.0",
+        "vite": "^7.1.11",
+        "vitest": "^3.2.4"
     }
 }

packages/code-link-cli/README.md

@@ -0,0 +1,3 @@
+# Framer Code Link CLI
+
+Two-way syncing Framer of code components between Framer and your computer.

packages/code-link-cli/package.json

@@ -0,0 +1,40 @@
+{
+    "name": "framer-code-link",
+    "version": "0.7.0",
+    "description": "CLI tool for syncing Framer code components - controller-centric architecture",
+    "main": "dist/index.mjs",
+    "type": "module",
+    "bin": "./dist/index.mjs",
+    "files": [
+        "dist"
+    ],
+    "scripts": {
+        "dev": "NODE_ENV=development tsx src/index.ts",
+        "build": "tsdown",
+        "start": "node dist/index.mjs",
+        "test": "vitest run"
+    },
+    "keywords": [
+        "framer",
+        "sync",
+        "code-components"
+    ],
+    "author": "",
+    "license": "MIT",
+    "dependencies": {
+        "@typescript/ata": "^0.9.8",
+        "chokidar": "^5.0.0",
+        "commander": "^14.0.3",
+        "prettier": "^3.7.4",
+        "typescript": "^5.9.3",
+        "ws": "^8.18.3"
+    },
+    "devDependencies": {
+        "@code-link/shared": "workspace:*",
+        "@types/node": "^22.19.2",
+        "@types/ws": "^8.18.1",
+        "tsdown": "^0.20.1",
+        "tsx": "^4.21.0",
+        "vitest": "^4.0.15"
+    }
+}