Skip to content

Document canonical Next 16 + TW 4 + ui-kit 0.9 stack migration#151

Open
policyengine[bot] wants to merge 1 commit into
mainfrom
bot/learnings-child-poverty-impact-dashboard
Open

Document canonical Next 16 + TW 4 + ui-kit 0.9 stack migration#151
policyengine[bot] wants to merge 1 commit into
mainfrom
bot/learnings-child-poverty-impact-dashboard

Conversation

@policyengine

@policyengine policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor

Summary

Add reference guide for Phase 2F batch sweep migrations that upgrade PolicyEngine frontend repos to the standardized stack:

  • Next.js: 14.x → ^16.2.6
  • React/React-DOM: 18.2.0 → ^19.2.0
  • Tailwind CSS: v3 → v4 (via @tailwindcss/postcss)
  • @policyengine/design-system 0.3.x → @policyengine/ui-kit ^0.9.0

What This Adds

New file: skills/frontend/policyengine-ui-kit-consumer-skill/references/canonical-stack-migration.md

Provides:

  • Step-by-step migration checklist (package.json updates, config file cleanup, CSS setup)
  • React 19 breaking changes guide (ref as prop, Context Provider changes)
  • Common issues and troubleshooting
  • Testing verification steps

Why This Helps

Future Claude Code sessions will encounter similar upgrade PRs as the Phase 2F sweep continues across PolicyEngine repos. This guide:

  • Explains what "canonical stack" means
  • Documents expected version targets
  • Provides a checklist to avoid missing steps
  • Highlights React 19 gotchas that aren't obvious from compiler errors

Source

Based on learnings from reviewing child-poverty-impact-dashboard PR #11, which upgraded frontend/ to this stack.

🤖 Generated with Claude Code

@PolicyEngine-Bot @claude
Document canonical Next 16 + TW 4 + ui-kit 0.9 stack migration
ca61a47 
Add reference guide for Phase 2F batch sweep migrations that upgrade
PolicyEngine frontend repos to the standardized stack (Next 16, React 19,
Tailwind 4, ui-kit 0.9).

Covers migration checklist, React 19 breaking changes, common issues, and
testing verification. Complements existing ui-kit consumer skill with
specific guidance for coordinated ecosystem upgrades.

Based on learnings from child-poverty-impact-dashboard PR #11 review.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

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

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

28 similar comments
@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

29 similar comments
@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

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

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@PolicyEngine-Bot