Shadcn Differ

ShadCN Project Differ: Automate ShadCN Update Specification

ShadCN Project Differ is a command-line utility designed for NextJS developers using ShadCN. It analyzes the modifications made to your project after the initial ShadCN setup and generates a structured JSON file. This output precisely captures your customizations, enabling you to seamlessly replicate them in new projects or integrate them into existing ones using the ShadCN CLI, streamlining the setup process for shared configurations or library integrations.

Features:

• Project Change Detection: Intelligently identifies differences between an initial ShadCN project commit and its current state.
• ShadCN JSON Generation: Outputs a well-structured JSON file detailing all detected project modifications suitable for ShadCN.
• Direct ShadCN CLI Integration: The generated JSON can be directly used with npx shadcn@latest init or npx shadcn@latest add commands for project setup or updates.
• Targeted Diffing Methodology: Focuses only on changes made after ShadCN installation by requiring a fresh initial commit for accurate results.
• src Directory Compatibility: Supports projects utilizing the src directory structure via the optional --src-dir flag.
• Facilitates Installer Creation: Enables library maintainers and SaaS providers to create one-step installers or project bootstrappers using the JSON output.
• Simplified Configuration Sharing: Facilitates sharing project configurations or component sets as a single, consumable JSON specification.

Summary:

ShadCN Project Differ simplifies managing and distributing NextJS project changes for ShadCN users. By diffing your project against an initial ShadCN setup, it produces a JSON file that the ShadCN CLI can use. This is ideal for creating reusable project starters, easily applying updates, or for library maintainers to provide straightforward integration steps for their users, effectively automating the transfer of project configurations.