Skip to content

ZenUml/conf-app / .claude/skills/local-dev

local-dev

Verified

Start a local development server for the Connect app and install it on a Confluence site via UPM. Use when setting up local dev, tunneling to Confluence, or installing the Connect app on a test site.

Local Development for Connect App

Set up the local dev environment and install the Connect app on a Confluence site.

Target site: $ARGUMENTS (default: diagramly.atlassian.net)

Step 1: Ensure wrangler.toml is linked

ls -la wrangler.toml

If not symlinked to wrangler-dev.toml, run pnpm wrangler:link.

Step 2: Check ports are free

lsof -i :8080 -i :8788

Port 8080 = Vite (frontend), port 8788 = Wrangler (backend). If occupied, stop the existing process first.

Step 3: Start the local server

pnpm start:sit

This runs:

  1. pnpm db:migrate:local — D1 migrations locally
  2. pnpm wrangler:serve — Wrangler on port 8788 (backend functions + static)
  3. pnpm start:local — Vite on port 8080 (frontend with HMR)

Vite proxies backend routes (/descriptor, /installed, /custom-content, /attachment, etc.) to Wrangler. See vite.config.mjs server.proxy.

Step 4: Expose via Cloudflare Tunnel

The peng tunnel routes 8080.diagramly.net → localhost:8080. It should already be running. Verify:

curl -s https://8080.diagramly.net/descriptor | head -c 200

If not running, start it: cloudflared tunnel run peng

Step 5: Uninstall conflicting Forge app (if needed)

A Connect app cannot be installed if a Forge app with the same key exists. If you hit connect.install.error.caas.override:

pnpm forge:use full    # or lite/dia
forge uninstall --site <site>.atlassian.net --product confluence -e <environment>

Step 6: Install via UPM REST API

The old UPM UI is deprecated. Use the browser's authenticated session. Navigate to the site's UPM page, then execute via browser console or Playwright browser_run_code:

// Get CSRF token
const tokenRes = await fetch('/wiki/rest/plugins/1.0/?os_authType=browser', { method: 'HEAD' });
const upmToken = tokenRes.headers.get('upm-token');

// Install
const res = await fetch('/wiki/rest/plugins/1.0/?token=' + upmToken, {
  method: 'POST',
  headers: { 'Content-Type': 'application/vnd.atl.plugins.remote.install+json' },
  body: JSON.stringify({ pluginUri: 'https://8080.diagramly.net/descriptor' })
});
const data = await res.json();

// Poll for completion (wait ~5s)
const taskRes = await fetch(data.links.self);
const result = await taskRes.json();
// result.done === true means success; result.error means failure

For lite: use https://8080.diagramly.net/descriptor?lite

Step 7: Verify

Open a Confluence page with a ZenUML macro. Console logs should show requests to 8080.diagramly.net instead of the production URL. Vite HMR means code changes reflect immediately.

Reference

See REFERENCE.md for tunnel hostnames, Forge app configs, and troubleshooting.

finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 318kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 318kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 318kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 196kUpdated Claude CodeCodexVerifiedInstall