Skip to content

Add Admin UI setup skill and integrate into migration workflow#347

Merged
borisno2 merged 2 commits intomainfrom
claude/add-admin-ui-migration-eEmBf
Mar 1, 2026
Merged

Add Admin UI setup skill and integrate into migration workflow#347
borisno2 merged 2 commits intomainfrom
claude/add-admin-ui-migration-eEmBf

Conversation

@borisno2
Copy link
Member

@borisno2 borisno2 commented Mar 1, 2026

Summary

This PR adds a new setup-admin-ui skill that automates the installation and configuration of the OpenSaaS Stack Admin UI in migrated Next.js projects. It integrates this skill into the migration assistant workflow as an optional step that runs after the main migration is complete.

Key Changes

  • New skill: setup-admin-ui (claude-plugins/opensaas-migration/skills/setup-admin-ui/SKILL.md)

    • Installs @opensaas/stack-ui dependency (matching @opensaas/stack-core version)
    • Creates catch-all admin route at app/{adminPath}/[[...{segmentName}]]/page.tsx
    • Generates auth-aware or auth-free page templates based on project configuration
    • Validates .opensaas/context availability and provides setup instructions
    • Detects auth configuration from opensaas.config.ts and lib/auth.ts
  • Updated migration assistant workflow (claude-plugins/opensaas-migration/agents/migration-assistant.md)

    • Renamed "Step 8" → "Step 11" (Run generation and validate) to accommodate new steps
    • Added Phase 5 — Admin UI (new step between migration and validation)
    • Prompts user with two questions: whether to set up Admin UI and at what path
    • Delegates to setup-admin-ui subagent with project root, admin path, and auth status
    • Updated final validation and getting-started instructions to reference the admin path

Implementation Details

  • The skill supports flexible admin paths (e.g., /admin, /dashboard/admin, /cms) by parsing the last path segment as the catch-all route parameter name
  • Two page templates provided: one for projects with auth enabled (includes session check and access denial UI), one without
  • Automatic package manager detection (pnpm/yarn/npm) for dependency installation
  • Graceful handling of missing .opensaas/context with user guidance to run pnpm generate
  • Clear reporting of what was installed and next steps for the user

https://claude.ai/code/session_019hziN9HYyNwoTgyHVxRyUC

Adds a new `setup-admin-ui` skill and integrates it into the migration
assistant as Phase 5. After completing the core migration steps, the
assistant now asks users whether they want the Admin UI set up and at
what path, then delegates to the skill to install @opensaas/stack-ui
and create the catch-all admin route page (with or without auth).

https://claude.ai/code/session_019hziN9HYyNwoTgyHVxRyUC
@changeset-bot
Copy link

changeset-bot bot commented Mar 1, 2026

⚠️ No Changeset found

Latest commit: 7ed51af

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@vercel
Copy link

vercel bot commented Mar 1, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
stack-docs Ready Ready Preview, Comment Mar 1, 2026 1:51am

@borisno2 borisno2 enabled auto-merge (squash) March 1, 2026 01:44
@borisno2 borisno2 merged commit 8a75a33 into main Mar 1, 2026
6 checks passed
@github-actions
Copy link
Contributor

github-actions bot commented Mar 1, 2026

Coverage Report for Core Package Coverage (./packages/core)

Status Category Percentage Covered / Total
🔵 Lines 86.17% 455 / 528
🔵 Statements 85.45% 464 / 543
🔵 Functions 97.22% 70 / 72
🔵 Branches 73.86% 325 / 440
File CoverageNo changed files found.
Generated in workflow #960 for commit 7ed51af by the Vitest Coverage Report Action

@github-actions
Copy link
Contributor

github-actions bot commented Mar 1, 2026

Coverage Report for UI Package Coverage (./packages/ui)

Status Category Percentage Covered / Total
🔵 Lines 76.03% 92 / 121
🔵 Statements 75.39% 95 / 126
🔵 Functions 75.6% 31 / 41
🔵 Branches 65.78% 75 / 114
File CoverageNo changed files found.
Generated in workflow #960 for commit 7ed51af by the Vitest Coverage Report Action

@github-actions
Copy link
Contributor

github-actions bot commented Mar 1, 2026

Coverage Report for CLI Package Coverage (./packages/cli)

Status Category Percentage Covered / Total
🔵 Lines 75.31% 1147 / 1523
🔵 Statements 74.93% 1190 / 1588
🔵 Functions 79.59% 156 / 196
🔵 Branches 64.36% 522 / 811
File CoverageNo changed files found.
Generated in workflow #960 for commit 7ed51af by the Vitest Coverage Report Action

@github-actions
Copy link
Contributor

github-actions bot commented Mar 1, 2026

Coverage Report for Auth Package Coverage (./packages/auth)

Status Category Percentage Covered / Total
🔵 Lines 64.49% 89 / 138
🔵 Statements 61.03% 94 / 154
🔵 Functions 74.46% 35 / 47
🔵 Branches 62.79% 54 / 86
File CoverageNo changed files found.
Generated in workflow #960 for commit 7ed51af by the Vitest Coverage Report Action

@github-actions
Copy link
Contributor

github-actions bot commented Mar 1, 2026

Coverage Report for Storage Package Coverage (./packages/storage)

Status Category Percentage Covered / Total
🔵 Lines 42.44% 73 / 172
🔵 Statements 42.77% 74 / 173
🔵 Functions 42.85% 15 / 35
🔵 Branches 40.13% 61 / 152
File CoverageNo changed files found.
Generated in workflow #960 for commit 7ed51af by the Vitest Coverage Report Action

@github-actions
Copy link
Contributor

github-actions bot commented Mar 1, 2026

Coverage Report for RAG Package Coverage (./packages/rag)

Status Category Percentage Covered / Total
🔵 Lines 47.97% 355 / 740
🔵 Statements 48.14% 377 / 783
🔵 Functions 54.26% 70 / 129
🔵 Branches 42.55% 180 / 423
File CoverageNo changed files found.
Generated in workflow #960 for commit 7ed51af by the Vitest Coverage Report Action

@github-actions
Copy link
Contributor

github-actions bot commented Mar 1, 2026

Coverage Report for Storage S3 Package Coverage (./packages/storage-s3)

Status Category Percentage Covered / Total
🔵 Lines 100% 40 / 40
🔵 Statements 100% 40 / 40
🔵 Functions 100% 9 / 9
🔵 Branches 100% 19 / 19
File CoverageNo changed files found.
Generated in workflow #960 for commit 7ed51af by the Vitest Coverage Report Action

@github-actions
Copy link
Contributor

github-actions bot commented Mar 1, 2026

Coverage Report for Storage Vercel Package Coverage (./packages/storage-vercel)

Status Category Percentage Covered / Total
🔵 Lines 100% 38 / 38
🔵 Statements 100% 38 / 38
🔵 Functions 100% 8 / 8
🔵 Branches 100% 22 / 22
File CoverageNo changed files found.
Generated in workflow #960 for commit 7ed51af by the Vitest Coverage Report Action

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants