petalframework/petal_components : guide éditorial fondé sur le README
Un guide fondé sur le README, les métadonnées et la licence de petalframework/petal_components.
Périmètre du projet
Le README décrit petalframework/petal_components comme « Phoenix + Live View HEEX Components ». Cette page reste limitée aux faits vérifiables dans le dépôt. Les étoiles, forks et badges indiquent une attention, pas une preuve de qualité. Sous « The 30-second pitch », la source indique : Petal Components gives Phoenix LiveView apps a shadcn-style set of HEEx components: buttons, forms, modals, tables, cards, and more. They are built with Tailwind v4 and work in live or dead views.. Cela fixe un périmètre déclaré, pas un test en production.
Cas d'usage adaptés
La section « For AI coding tools » aide à vérifier si le projet répond au besoin : The component naming map (HEEx tag form, module path, CSS class prefix). Si ce besoin ne correspond pas au vôtre, la popularité ne suffit pas. Les noms, commandes et composants sont conservés pour permettre une comparaison directe avec la source primaire. Le README fournit aussi ce point vérifiable : Always reach for an existing petalcomponents tag before hand-rolling HEEx. Il peut guider le premier test, sans remplacer une vérification dans l'environnement prévu.
Fonctionnement
Le fonctionnement est réparti dans des sections comme « The 30-second pitch ». La source fournit notamment : If you have used shadcn in React, you already know the shape. Same idea, composable primitives, you own the patterns, AI tools read the schema and call it correctly. We just write HEEx, not JSX.. Les détails absents sur l'architecture, les performances ou la sécurité ne sont pas inventés. Avant une mise en service, vérifiez l'arborescence, la configuration et l'historique des releases.
Installation et premier lancement
Commencez l'installation avec l'entrée documentée dans le README. La commande vérifiable est : git clone https://github.com/petalframework/petal_components.git cd petal_components mix deps.get mix tailwind.install iex -S mix run dev.exs Si aucune commande n'est fournie, cette page n'en fabrique pas. Consultez « Install » pour les dépendances, les ports par défaut et l'initialisation du premier lancement.