Communitygithub.com

KazmerMaximiliano/neus-ui — Landing Générique

Génère une page d'accueil flexible et généraliste avec section héro, blocs de contenu et appel à l'action. Produit un fichier .tsx utilisant les composants Button, Card et Link de Neus UI. Pas de AppTemplate.

Qu'est-ce que neus-ui — Landing Générique ?

Cette compétence génère une page d'accueil généraliste (landing page) avec une section héro, des blocs de contenu et un appel à l'action (CTA). Elle produit un fichier .tsx exploitant les composants Neus UI Button, Card et Link, et ne doit pas être utilisée avec AppTemplate. Elle est conçue pour les contextes qui ne correspondent pas à un produit SaaS — par exemple les pages portfolio, entreprise, événement, agence ou personnelles. Le skill utilise un système de directives visuelles (palette, personnalité, mode clair/sombre) qui transforme les réponses de l'utilisateur en choix de design précis. Il génère trois fichiers (types TypeScript, composant React, feuille de styles CSS) avec des règles strictes d'accessibilité, de mode sombre et d'utilisation des composants Neus UI. Il inclut aussi des vérifications phase par phase pour garantir que la sortie respecte exactement les sections demandées par l'utilisateur et n'ajoute rien de superflu.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/KazmerMaximiliano/neus-ui/tree/HEAD/.agents/skills/neus-landing-generic

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Neus Landing Générique

Génère une page d'accueil généraliste avec section héro, blocs de contenu et appel à l'action. S'adapte à l'objectif de l'utilisateur.

IMPORTANT : Pas de AppTemplate. Page publique.


Avant de commencer

Les « Règles partagées » ci-dessous sont toujours actives. Lisez également TOUS ces fichiers avant la Phase 0 :

  • .agents/skills/_shared/anti-slop.md — règles qualité obligatoires (section « Pages marketing »)
  • .agents/skills/_shared/prop-constraints.md — props interdites et composants inexistants
  • .agents/skills/_shared/component-catalog.md — sections Button, Card, Link, Input
  • .agents/skills/_shared/design-personality.md — axe de personnalité, format DIRECTIVE VISUELLE, Section 9 recettes de surface mode sombre
  • .agents/skills/_shared/dark-surfaces.md — recettes CSS mode sombre (à lire quand Mode: dark)
  • .agents/skills/_shared/light-surfaces.md — recettes CSS mode clair (à lire quand Mode: light)
  • .agents/skills/_shared/checklist.md — portes P0/P1/P2
  • .agents/skills/_shared/layout-patterns.md — motifs de page d'accueil (ligne de statistiques, split section-en-tête, pilule d'œil de héro, navigation adaptative au mode)
  • .agents/skills/neus-landing-generic/references/dark-landing-patterns.md — anatomie de mise en page de section et motifs JSX pour les pages d'accueil en mode sombre

Phase 0 — Collecte de données

Posez ces questions à l'utilisateur et attendez sa réponse complète avant de continuer :


  1. De quel type de page s'agit-il ? (portfolio, entreprise, événement, agence, blog, personnel, autre)
  2. Nom / marque de la page
  3. Titre principal (H1) — peut inclure un mot d'accent pour un effet dégradé
  4. Slogan ou sous-titre
  5. Sections à inclure (liste exacte — n'en ajoutez pas)
  6. CTA principal : libellé + action
  7. CTA secondaire (optionnel) : libellé + action
  8. Couleur thème principale (hexadécimale ou description)
  9. Mode : clair ou sombre ?
  10. Personnalité : propre/aéré, éditorial/calque, audacieux/cinétique, ou structuré ? (si incertain, décrivez l'ambiance)
  11. Inclut-il un formulaire de contact ou une newsletter ? (oui/non — précisez lequel)

Phase 1 — Résolution visuelle

Avant d'écrire du code, résolvez la DIRECTIVE VISUELLE à partir des réponses collectées.

Correspondance des palettes :

  • Couleurs vives / énergiques → Vibrant
  • Tons neutres / sourds / gris → Neutre
  • Bleus / verts d'entreprise → Corporate
  • Violet / rose / créatif → Créatif

Correspondance des personnalités depuis la Q10 :

  • propre / minimal / aéré → Aéré
  • éditorial / calque / asymétrique → Calque
  • audacieux / fort / cinétique → Cinétique
  • structuré / formel / dense en données → Structuré

Construisez ce bloc et reportez-le dans la Phase 2 :

DIRECTIVE VISUELLE :
- Palette : [Vibrant / Neutre / Corporate / Créatif]
- Personnalité : [Cinétique / Aéré / Structuré / Calque]
- Mode : [clair / sombre]
- Animation : [neus-fade-up sur .hero-copy / aucun]
- Mise en page : [héro asymétrique 2 colonnes 1.4fr/0.6fr / héro centrée]
- H1 : [clamp(2.5rem,6vw,4rem) weight-800 / clamp(2rem,4vw,3rem) weight-700]
- Texte dégradé : [oui — mot d'accent : "[mot]" / non]
- Surfaces : [verre (dark-surfaces.md) / standard var(--color-white)]
- Navigation : [verre collante / standard collante / aucune]

Règle mode sombre : Si Mode: dark, TOUTES les surfaces utilisent les recettes de dark-surfaces.md. N'utilisez jamais var(--color-white) comme fond de page ou de section. Utilisez <Card variant="glass"> pour les cartes de contenu — c'est la surface en verre Neus UI. Ne remplacez jamais par une <div> brute + CSS personnalisé.

Règle mode clair : Si Mode: light, utilisez <Card> Neus UI pour les cartes de contenu, var(--color-primary-light) pour les fonds de section en alternance, var(--color-white) pour la racine de la page.


Phase 2 — Vérification P0

  • Sections produites == sections collectées (Q5). Zéro supplémentaire.
  • Pas de texte inventé — tout texte provient de la collecte ou est explicitement piloté par les props
  • Pas de AppTemplate ni de barre latérale
  • DIRECTIVE VISUELLE construite et reportée
  • Mode sombre : toutes les surfaces utilisent les recettes verre, pas de fond var(--color-white)
  • Mode clair : <Card> Neus UI utilisé pour le contenu, primary-light pour les sections en alternance

Phase 3 — Générer l'artefact

Produisez trois fichiers dans cet ordre : NomPage.types.ts → NomPage.tsx → NomPage.styles.css.


NomPage.types.ts

import type { BadgeColor } from 'neus-ui';

export type NavItem = {
  label: string;
  href: string;
};

// Ajoutez des types spécifiques aux sections dérivés uniquement de la collecte
export type Article = {
  id: string;
  title: string;
  href?: string;
  excerpt?: string;
  author?: string;
  meta?: string;
  categories?: string[];
};

// Catégorie → correspondance de couleur de badge (mode sombre : 4 couleurs visuellement distinctes)
export const BADGE_COLOR: Record<string, BadgeColor> = {
  systems:  "primary",
  design:   "error",
  craft:    "neutral",
  tools:    "success",
  featured: "primary",
};

export type PageNameProps = {
  // Props uniquement pour les données provenant de l'extérieur (liste d'articles, gestionnaires de formulaire, etc.)
  // Le texte marketing statique est codé en dur dans le composant — jamais comme prop
};

NomPage.tsx

Structure mode sombre — utilisation correcte des composants :

import { useState } from 'react';
import { Button, Card, Link, Input, Badge } from 'neus-ui';
import './NomPage.styles.css';
import type { NomPageProps, Article } from './NomPage.types';
import { BADGE_COLOR } from './NomPage.types';

export const PageName = ({ articles, onSubscribe }: NomPageProps) => {
  const [email, setEmail] = useState('');
  const [subscribed, setSubscribed] = useState(false);
  const [loading, setLoading] = useState(false);

  const handleSubscribe = () => {
    setLoading(true);
    onSubscribe?.(email);
    setSubscribed(true);
    setLoading(false);
  };

  return (
    <div className="page-name">
      {/* Couches de fond décoratives — aria-hidden, aucune interaction */}
      <div className="page-name__mesh" aria-hidden="true" />
      <div className="page-name__grid" aria-hidden="true" />

      <div className="page-name__content">
        {/* Navigation collante en verre — les liens utilisent <Link type="secondary"> */}
        <nav className="page-name__nav">
          <div className="page-name__nav-brand">
            <div className="page-name__brand-mark" aria-hidden="true">P</div>
            <span className="page-name__brand-name">NomPage</span>
          </div>
          <div className="page-name__nav-links">
            {navItems.map(item => (
              <Link key={item.href} type="secondary" href={item.href} label={item.label} />
            ))}
          </div>
          <Button label="S'abonner" variant="solid" color="primary" size="small" onClick={() => {}} />
        </nav>

        <main>
          {/* Héro — asymétrique 2 colonnes */}
          <section className="page-name__hero" aria-labelledby="page-name-title">
            <div className="page-name__hero-copy">
              {/* Pilule d'œil — div brute (pas d'équivalent Neus UI) */}
              <div className="page-name__eyebrow-pill">
                <span className="page-name__eyebrow-dot" aria-hidden="true" />
                NOMPAGE
                <span aria-hidden="true">/</span>
                MOTCLÉ
              </div>
              <h1 id="page-name-title">
                Titre{" "}
                <span className="gradient-text">accent</span>
              </h1>
              <p className="page-name__hero-sub">Slogan issu de la collecte.</p>
              <div className="page-name__hero-cta">
                <Button label="CTA Principal" variant="solid" color="primary" onClick={() => {}} />
                <Button label="CTA Secondaire" variant="outlined" color="primary" onClick={() => {}} />
              </div>
            </div>
            <div className="page-name__hero-visual">
              {/* Carte vedette ou panneau artistique — voir dark-landing-patterns.md §4 */}
            </div>
          </section>

          {/* Sections de contenu issues de la collecte — utilisez <Card variant="glass"> pour les cartes */}
          {/* Exemple de grille d'articles : */}
          <section className="page-name__articles">
            <div className="page-name__article-grid">
              {articles?.map(article => (
                <Card variant="glass" key={article.id} onClick={() => {}}>
                  <div className="page-name__article-inner">
                    <div className="page-name__pill-row">
                      {article.categories?.map(cat => (
                        <Badge
                          key={cat}
                          variant="solid"
                          color={BADGE_COLOR[cat] ?? "neutral"}
                          label={cat}
                        />
                      ))}
                    </div>
                    <h3>{article.title}</h3>
                    {article.excerpt && <p className="page-name__article-dek">{article.excerpt}</p>}
                  </div>
                </Card>
              ))}
            </div>
          </section>

          {/* Section newsletter (si demandée) */}
          <section className="page-name__newsletter" aria-labelledby="page-name-nl-title">
            <div className="page-name__nl-card">
              <p className="page-name__sec-eyebrow">Newsletter</p>
              <h2 id="page-name-nl-title">
                Restez dans le coup.{" "}
                <span className="gradient-text">Pas de bruit.</span>
              </h2>
              {subscribed ? (
                <p className="page-name__nl-success">✓ Vous êtes abonné — merci !</p>
              ) : (
                <div className="page-name__nl-form">
                  <Input
                    name="newsletter-email"
                    type="email"
                    label="E-mail"
                    placeholder="[email protected]"
                    value={email}
                    onChange={setEmail}
                    required
                  />
                  <Button
                    label="S'abonner"
                    type="submit"
                    variant="solid"
                    color="primary"
                    loading={loading}
                    onClick={handleSubscribe}
                  />
                </div>
              )}
            </div>
          </section>
        </main>

        {/* Pied de page — les liens utilisent <Link type="secondary"> */}
        <footer className="page-name__footer">
          <span>© {new Date().getFullYear()} NomPage.</span>
          <div className="page-name__footer-links">
            <Link type="secondary" href="/privacy" label="Confidentialité" />
            <Link type="secondary" href="/contact" label="Contact" />
          </div>
        </footer>
      </div>
    </div>
  );
};

Structure mode clair : Omettez les divs mesh/grid et le wrapper de contenu. Utilisez <Card> (sans variant) pour les cartes de contenu. Alternez les fonds de section avec background: var(--color-primary-light). Utilisez <Link type="primary"> pour les liens principaux, <Link type="secondary"> pour la navigation et le pied de page. Les pilules de catégorie utilisent toujours <Badge>.

Tuile de fonctionnalité (les deux modes) :

  • <Card variant="glass" icon={...} title="..." description="..." /> (sombre)
  • <Card icon={...} title="..." description="..." /> (clair)

Formulaire de contact (si demandé) : Utilisez les champs <Input> Neus UI + <Button type="submit">. Même motif que la newsletter mais sans le wrapper de carte lumineuse.


NomPage.styles.css

Mode sombre : Commencez par les recettes canvas + mesh + grid + contenu de dark-surfaces.md §1. Ajoutez ensuite la navigation en verre (§3), nl-card (§4), pilule d'œil (§5), texte dégradé (§6), panneau artistique (§8 si présenté), ligne de meta (§9 si articles), pied de page (§10). Pas de CSS de carte personnalisé — <Card variant="glass"> s'en charge. Appliquez la mise en page de dark-landing-patterns.md.

Mode clair : Commencez par background: var(--color-white); color: var(--color-gray-900). Utilisez var(--color-primary-light) pour les fonds de section en alternance. Suivez la section 4–5 de design-personality.md pour la typographie et l'espacement.

Les deux modes :

@keyframes neus-fade-up {
  from { opacity: 0; transform: translateY(16px); }
  to   { opacity: 1; transform: translateY(0); }
}

.page-name__hero-copy {
  animation: neus-fade-up 0.5s ease both;
}

/* Utilitaire de texte dégradé */
.gradient-text {
  background: linear-gradient(135deg, #22d3ee 0%, #818cf8 45%, #d946ef 100%);
  -webkit-background-clip: text;
  -webkit-text-fill-color: transparent;
  background-clip: text;
}

/* Conteneurs de largeur maximale */
.page-name__hero,
.page-name__articles,
.page-name__newsletter,
.page-name__footer {
  max-width: min(72rem, 100%);
  margin: 0 auto;
}

/* Remplissage des sections */
.page-name__hero       { padding: 6rem 2rem; }
.page-name__articles   { padding: 6rem 2rem; }
.page-name__newsletter { padding: 5rem 2rem; }

/* Grille héro */
.page-name__hero {
  display: grid;
  grid-template-columns: 1.4fr 0.6fr;
  gap: 3rem;
  align-items: center;
}

/* H1 */
.page-name__hero h1 {
  font-family: var(--font-display);
  font-size: clamp(2.5rem, 6vw, 4rem);
  font-weight: 800;
  letter-spacing: -0.04em;
  line-height: 0.98;
  margin: 0.5rem 0 1rem;
}

/* Formulaire newsletter — rangée flexible */
.page-name__nl-form {
  display: flex;
  gap: 1rem;
  align-items: flex-end;
  max-width: 520px;
  margin: 0 auto;
}

/* Grille d'articles */
.page-name__article-grid {
  display: grid;
  grid-template-columns: repeat(3, 1fr);
  gap: 1.5rem;
}

/* Rangée de pilules */
.page-name__pill-row {
  display: flex;
  flex-wrap: wrap;
  gap: 0.5rem;
  margin-bottom: 0.75rem;
}

/* Responsive */
@media (max-width: 960px) {
  .page-name__hero { grid-template-columns: 1fr; }
  .page-name__article-grid { grid-template-columns: 1fr; }
}
@media (max-width: 640px) {
  .page-name__hero,
  .page-name__articles,
  .page-name__newsletter { padding: 5rem 1.25rem; }
}

Règles partagées (intégrées)

Ces règles sont toujours actives. Elles s'appliquent même si les fichiers _shared/ ne sont pas lus.

Sortie — toujours trois fichiers

Chaque sortie de compétence : NomComposant.types.ts → NomComposant.tsx → NomComposant.styles.css. Pas de styles en ligne (style={{}}). Pas de balises <style> à l'intérieur des composants. CSS uniquement dans .styles.css.

Importations

import { Button, Card, Input, Badge, Link, Select, Modal, DataTable } from 'neus-ui';

Ne jamais…

…

[truncué pour la traduction]

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Skills associés