square-ui Documentation

Technical Documentation: ln-dev7/square-ui

ℹ️ Provenance: Multi-Tier Ingestion · CodeWiki Reference

Overview (`README.md`) Copy Section

Square UI

Square UI is a collection of free, open-source admin dashboard templates for shadcn/ui. The layouts are built with Next.js and Tailwind CSS, and each one is a complete starting point you can clone, copy, and ship — dashboards, email, chat, calendars, file managers, and more.

Browse the live catalog at square.lndevui.com.

Want the Pro collection? Shadcn Dashboard has 20+ more premium shadcn admin templates — commercial license, full pages, and lifetime updates.

Free Templates Copy Chapter

Note: Templates using Radix UI are located in templates/, while templates using Base UI are in templates-baseui/.

Pro Templates Copy Chapter

These are the Shadcn Dashboard Pro templates — commercial license, Radix + Base UI variants, full pages, and lifetime updates.

Browse all Pro templates on Shadcn Dashboard →

🛠️ Technologies Copy Chapter

• Framework: Next.js
• Langage: TypeScript
• UI Components: shadcn/ui
• Styling: Tailwind CSS

Star History Copy Chapter

Powered by Shadcnblocks.com Copy Chapter

Also see Shadcnblocks for 2000+ shadcn/ui blocks and components.

Overview (`home/scripts/README.md`) Copy Section

Scripts de Migration du Registry

Ce dossier contient les scripts utilitaires pour gérer et maintenir les fichiers JSON du registry.

📋 Scripts disponibles Copy Chapter

`add-content-to-registry.js` Copy Section

Script principal qui ajoute automatiquement le champ content aux fichiers JSON du registry. Ce champ contient le contenu complet des fichiers référencés par les URLs GitHub.

🚀 Utilisation Copy Chapter

Commande de base Copy Section

cd home
node scripts-migration/add-content-to-registry.js

Options disponibles Copy Section

Exemples d'utilisation Copy Section

1. Exécution normale

Ajoute le champ content aux nouveaux fichiers JSON qui n'en ont pas encore.

node scripts-migration/add-content-to-registry.js

2. Mode simulation (dry-run)

Voir ce qui sera fait sans modifier les fichiers.

node scripts-migration/add-content-to-registry.js --dry-run

3. Mode verbeux

Afficher tous les détails de traitement, y compris les fichiers déjà à jour.

node scripts-migration/add-content-to-registry.js --verbose

4. Forcer la mise à jour

Mettre à jour tous les fichiers, même ceux qui ont déjà un content.

node scripts-migration/add-content-to-registry.js --force

5. Combinaison d'options

Combiner plusieurs options pour un contrôle total.

# Simulation avec détails
node scripts-migration/add-content-to-registry.js --dry-run --verbose

# Mise à jour forcée avec détails
node scripts-migration/add-content-to-registry.js --force --verbose

📖 Comment ça fonctionne Copy Chapter

Processus Copy Section

1. Détection automatique : Le script parcourt automatiquement tous les fichiers .json dans home/public/registry/

2. Validation : Chaque fichier JSON est validé avant traitement

3. Traitement : Pour chaque fichier JSON :

   • Parcourt le tableau files
   • Extrait les path qui pointent vers GitHub (https://raw.githubusercontent.com/ln-dev7/square-ui/master/templates/...)
   • Convertit l'URL GitHub en chemin local (templates/...)
   • Lit le contenu du fichier local
   • Ajoute le champ content avec le contenu complet

4. Sauvegarde : Les fichiers JSON sont mis à jour avec le nouveau champ content

Format du champ `content` Copy Section

Le champ content est ajouté juste après le champ path dans chaque entrée du tableau files :

{
  "files": [
    {
      "path": "https://raw.githubusercontent.com/ln-dev7/square-ui/master/templates/chat/components/chat/chat-input-box.tsx",
      "type": "registry:component",
      "target": "components/chat-input-box.tsx",
      "content": "import { ... } from \"lucide-react\";\n..."
    }
  ]
}

📊 Statistiques Copy Chapter

Le script affiche un résumé détaillé après l'exécution :

📊 RÉSUMÉ
============================================================

📁 Fichiers JSON:
   Total:        22
   Traités:      22
   Mis à jour:   0
   Déjà à jour:  22
   Ignorés:      0
   Erreurs:      0

📄 Fichiers de contenu:
   Total:              89
   Ajoutés:            0
   Déjà présents:      89
   Introuvables:       0
   Erreurs:            0

⚠️ Gestion des erreurs Copy Chapter

Le script gère plusieurs types d'erreurs :

• JSON invalide : Fichier JSON mal formé
• Fichier introuvable : Le fichier référencé n'existe pas localement
• Erreur de lecture : Impossible de lire le fichier
• Erreur d'écriture : Impossible de sauvegarder le JSON

Toutes les erreurs sont affichées dans le résumé avec les détails nécessaires pour le débogage.

🔄 Workflow recommandé Copy Chapter

Ajouter un nouveau composant au registry Copy Section

1. Créer le fichier JSON dans home/public/registry/
2. Ajouter les path avec les URLs GitHub
3. Exécuter le script :

node scripts-migration/add-content-to-registry.js

Le script détectera automatiquement le nouveau fichier et ajoutera le content pour tous les fichiers référencés.

Vérifier avant de commiter Copy Section

Avant de commiter vos changements, utilisez le mode dry-run pour vérifier :

node scripts-migration/add-content-to-registry.js --dry-run --verbose

📁 Structure des fichiers Copy Chapter

home/
├── scripts-migration/
│   ├── add-content-to-registry.js  # Script principal
│   ├── copy-registry-files.js      # Script de copie (ancien)
│   ├── verify-registry.js          # Script de vérification (ancien)
│   └── README.md                   # Cette documentation
├── public/
│   └── registry/                   # Fichiers JSON du registry
│       ├── chat.json
│       ├── chat-input-box.json
│       └── ...
└── templates/                      # Templates source
    ├── chat/
    ├── emails/
    └── task-management/

🛠️ Prérequis Copy Chapter

• Node.js (version 12 ou supérieure)
• Accès au répertoire templates/ avec les fichiers sources

💡 Conseils Copy Chapter

• Utilisez --dry-run avant de faire des modifications importantes
• Utilisez --verbose pour déboguer les problèmes
• Utilisez --force avec précaution, seulement si vous voulez vraiment tout mettre à jour
• Le script est idempotent : vous pouvez l'exécuter plusieurs fois sans problème

🐛 Dépannage Copy Chapter

Le script ne trouve pas les fichiers Copy Section

Vérifiez que :

• Les fichiers existent dans templates/
• Les URLs GitHub dans les JSON sont correctes
• Le format de l'URL correspond à : https://raw.githubusercontent.com/ln-dev7/square-ui/master/templates/...

Le script ne met pas à jour certains fichiers Copy Section

• Vérifiez que les fichiers ont bien un tableau files
• Vérifiez que les path commencent par l'URL GitHub correcte
• Utilisez --verbose pour voir les détails
• Utilisez --force si le content existe déjà et que vous voulez le mettre à jour

📝 Notes Copy Chapter

• Le script préserve le formatage JSON existant (indentation de 2 espaces)
• Les fichiers sont triés alphabétiquement pour un traitement cohérent
• Le script ignore automatiquement les fichiers qui n'ont pas de tableau files
• Les chemins non-GitHub sont ignorés silencieusement (sauf en mode verbose)

🔗 Liens utiles Copy Chapter

• Documentation shadcn/ui Registry
• Format du registry JSON

Overview (`templates-baseui/chat/README.md`) Copy Section

This is a Next.js project bootstrapped with create-next-app.

Getting Started Copy Chapter

First, run the development server:

npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev

Open http://localhost:3000 with your browser to see the result.

You can start editing the page by modifying app/page.tsx. The page auto-updates as you edit the file.

This project uses next/font to automatically optimize and load Geist, a new font family for Vercel.

Learn More Copy Chapter

To learn more about Next.js, take a look at the following resources:

• Next.js Documentation - learn about Next.js features and API.
• Learn Next.js - an interactive Next.js tutorial.

You can check out the Next.js GitHub repository - your feedback and contributions are welcome!

Deploy on Vercel Copy Chapter

The easiest way to deploy your Next.js app is to use the Vercel Platform from the creators of Next.js.

Check out our Next.js deployment documentation for more details.

Overview (`templates-baseui/dashboard-1/README.md`) Copy Section

This is a Next.js project bootstrapped with create-next-app.

Getting Started Copy Chapter

First, run the development server:

npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev

Open http://localhost:3000 with your browser to see the result.

You can start editing the page by modifying app/page.tsx. The page auto-updates as you edit the file.

This project uses next/font to automatically optimize and load Geist, a new font family for Vercel.

Learn More Copy Chapter

To learn more about Next.js, take a look at the following resources:

• Next.js Documentation - learn about Next.js features and API.
• Learn Next.js - an interactive Next.js tutorial.

You can check out the Next.js GitHub repository - your feedback and contributions are welcome!

Deploy on Vercel Copy Chapter

The easiest way to deploy your Next.js app is to use the Vercel Platform from the creators of Next.js.

Check out our Next.js deployment documentation for more details.

--- METRICS ---

• Files Extracted: 4
• Estimated Token Budget: ~6331 tokens
• Canonical Reference: https://codewiki.google/github.com/ln-dev7/square-ui