Skip to content

[Feature] Add curated UI source adapters and stack compatibility resolver #142

Closed

Description

@EagleFox31

Parent: #120
Migrated from: EagleFox31/appfactory-project-automation#97

Goal

Let AppFactory choose the safe adoption mode for vetted UI sources instead of treating every repository like the same stack.

Initial source classes

  • external discovery/MCP adapters such as 21st.dev;
  • reviewed copy/adapt sources such as Magic UI, UI Layouts and beUI;
  • compatible registry/block sources such as shadcn/Tailark;
  • guideline/reference sources such as Web Interface Guidelines.

Scope

  • resolve native, adapt, reference-only, unsupported;
  • separate external adapters from code-copy sources;
  • block registry installs when the required stack is absent;
  • avoid duplicate animation runtimes;
  • expose source selection as pure/testable logic;
  • keep external services optional.

Proof of Done

  • React/Vite+CSS chooses adaptation/reference rather than installing Tailwind;
  • React/Next+Tailwind can use approved registry sources;
  • non-React consumers get reference-only unless an adapter exists;
  • no arbitrary upstream install command executes;
  • compatibility tests cover the initial allowlist.

Activity

  1. EagleFox31 commented on Oct 10, 2026

    @EagleFox31
    ContributorAuthor

    Delivered — 2026-10-10

    Merged PR #148 into main, commit 0ab983a26d4e1740fbc64690d6fb8758de544b23.

    Evidence

    • PR CI green
    • Post-merge main CI green
    • New ui-registry/wow-adapters.json + schema and pure ui-registry/wow-resolver.mjs.
    • All nine research sources have strict type-matched adapter metadata. Technical fit (native/adapt/reference-only) is separated from central legal/policy disposition, producing reference-only or unsupported where permissions are missing.
    • Tailwind sources are adaptation references for React/Vite+CSS (no framework migration); native-fit references for React/Next+Tailwind; non-React remains design reference without code reuse.
    • Optional external MCP is advisory only. Motion/GSAP/Three are possible per-component dependency hints, existing runtimes are preferred, none auto-installed.
    • scripts/wow-frontend-plan.mjs now includes adapterResolutions, tested through npm run test:ui-registry.
    • No new external source approvals, imports, npm dependencies, network calls, consumer edits, Worker deploy or overlapping PR Add PostgreSQL migration gate to Worker releases #74 changes.

    Limit: #142 delivers selection/planning, not actual third-party code installation, connected hosted tool execution, or visual browser QA. The next acceptance gates are rendered QA in Project Automation #99 and the Commerce Factory pilot #143; reusable native motion recipes live in the landing template #6.

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions