¿Qué hace Neus Landing Genérica?
Genera una landing page de uso general con sección hero, bloques de contenido y CTA. Se adapta al propósito del usuario.
IMPORTANTE: Sin AppTemplate. Página pública.
Antes de empezar
La sección "Reglas Compartidas" a continuación está siempre activa. Además, lee TODAS estas antes de la Fase 0:
.agents/skills/_shared/anti-slop.md— reglas de calidad obligatorias (sección "Páginas de Marketing").agents/skills/_shared/prop-constraints.md— props prohibidas y componentes inexistentes.agents/skills/_shared/component-catalog.md— secciones de Button, Card, Link, Input.agents/skills/_shared/design-personality.md— ejes de personalidad, formato DIRECTIVA VISUAL, recetas de superficies en modo oscuro de la Sección 9.agents/skills/_shared/dark-surfaces.md— recetas CSS para modo oscuro (leer cuando el modo sea: oscuro).agents/skills/_shared/light-surfaces.md— recetas CSS para modo claro (leer cuando el modo sea: claro).agents/skills/_shared/checklist.md— compuertas P0/P1/P2.agents/skills/_shared/layout-patterns.md— patrones de landing (fila de estadísticas, división sección-cabecera, pastilla hero, navegación adaptable al modo).agents/skills/neus-landing-generic/references/dark-landing-patterns.md— anatomía del layout de secciones y patrones JSX para landings en modo oscuro
Fase 0 — Recopilar datos
Haz al usuario estas preguntas y espera su respuesta completa antes de continuar:
- ¿Qué tipo de página es? (portafolio, empresa, evento, agencia, blog, personal, otro)
- Nombre de la página / marca
- Titular principal (H1) — puede incluir una palabra destacada para efecto degradado
- Subtítulo o tagline
- Secciones a incluir (enumera exactamente — no añadas más)
- CTA principal: etiqueta + acción
- CTA secundaria (opcional): etiqueta + acción
- Color de tema principal (hex o descripción)
- Modo: claro u oscuro?
- Personalidad: limpia/aireada, editorial/capas, audaz/cinética, o estructurada? (si no sabes, describe la vibra)
- ¿Incluye formulario de contacto o newsletter? (sí/no — especifica cuál)
Fase 1 — Resolución Visual
Antes de escribir cualquier código, resuelve la DIRECTIVA VISUAL a partir de las respuestas obtenidas.
Mapeo de paleta:
- Colores vibrantes / enérgicos → Vibrante
- Tonos neutros / apagados / grises → Neutro
- Azules / verdes corporativos → Corporativo
- Púrpura / rosa / creativo → Creativo
Mapeo de personalidad desde la Q10:
- limpio / minimalista / aireado → Aireado
- editorial / capas / asimétrico → Capas
- audaz / fuerte / cinético → Cinético
- estructurado / formal / denso en datos → Estructurado
Construye este bloque y llévalo a la Fase 2:
DIRECTIVA VISUAL:
- Paleta: [Vibrante / Neutro / Corporativo / Creativo]
- Personalidad: [Cinético / Aireado / Estructurado / Capas]
- Modo: [claro / oscuro]
- Animación: [neus-fade-up en .hero-copy / ninguno]
- Layout: [hero asimétrico 2 columnas 1.4fr/0.6fr / hero centrado]
- H1: [clamp(2.5rem,6vw,4rem) weight-800 / clamp(2rem,4vw,3rem) weight-700]
- Texto degradado: [sí — palabra destacada: "[palabra]" / no]
- Superficies: [glass (dark-surfaces.md) / estándar var(--color-white)]
- Nav: [glass sticky / estándar sticky / ninguno]
Regla de modo oscuro: Si Modo: oscuro, TODAS las superficies usan las recetas de dark-surfaces.md. Nunca uses var(--color-white) como fondo de página o sección. Usa <Card variant="glass"> para tarjetas de contenido — es la superficie glass de Neus UI. Nunca lo reemplaces por un <div> plano + CSS personalizado.
Regla de modo claro: Si Modo: claro, usa <Card> de Neus UI para tarjetas de contenido, var(--color-primary-light) para fondos de secciones alternas, var(--color-white) para la raíz de la página.
Fase 2 — Verificación P0
- Secciones de salida == secciones de la recopilación (Q5). Cero extras.
- Sin texto inventado — todo el texto proviene de la recopilación o está explícitamente impulsado por props
- Sin AppTemplate ni barra lateral
- DIRECTIVA VISUAL construida y llevada adelante
- Modo oscuro: todas las superficies usan recetas glass, sin fondos
var(--color-white) - Modo claro:
<Card>de Neus UI usado para contenido, primary-light para secciones alternas
Fase 3 — Generar Artefacto
Produce tres archivos en este orden: NombrePagina.types.ts → NombrePagina.tsx → NombrePagina.styles.css.
NombrePagina.types.ts
import type { BadgeColor } from 'neus-ui';
export type NavItem = {
label: string;
href: string;
};
// Añadir tipos específicos de sección derivados solo de la recopilación
export type Article = {
id: string;
title: string;
href?: string;
excerpt?: string;
author?: string;
meta?: string;
categories?: string[];
};
// Categoría → mapeo de color de Badge (modo oscuro: 4 colores visualmente distintos)
export const BADGE_COLOR: Record<string, BadgeColor> = {
systems: "primary",
design: "error",
craft: "neutral",
tools: "success",
featured: "primary",
};
export type NombrePaginaProps = {
// Props solo para datos que vienen de fuera (lista de artículos, manejadores de formularios, etc.)
// El texto de marketing estático está hardcodeado en el componente — nunca como prop
};
NombrePagina.tsx
Estructura de modo oscuro — uso correcto de componentes:
import { useState } from 'react';
import { Button, Card, Link, Input, Badge } from 'neus-ui';
import './NombrePagina.styles.css';
import type { NombrePaginaProps, Article } from './NombrePagina.types';
import { BADGE_COLOR } from './NombrePagina.types';
export const NombrePagina = ({ articles, onSubscribe }: NombrePaginaProps) => {
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="nombre-pagina">
{/* Capas decorativas de fondo — aria-hidden, sin interacción */}
<div className="nombre-pagina__mesh" aria-hidden="true" />
<div className="nombre-pagina__grid" aria-hidden="true" />
<div className="nombre-pagina__content">
{/* Nav glass sticky — los enlaces usan <Link type="secondary"> */}
<nav className="nombre-pagina__nav">
<div className="nombre-pagina__nav-brand">
<div className="nombre-pagina__brand-mark" aria-hidden="true">P</div>
<span className="nombre-pagina__brand-name">NombrePagina</span>
</div>
<div className="nombre-pagina__nav-links">
{navItems.map(item => (
<Link key={item.href} type="secondary" href={item.href} label={item.label} />
))}
</div>
<Button label="Suscribirse" variant="solid" color="primary" size="small" onClick={() => {}} />
</nav>
<main>
{/* Hero — asimétrico 2 columnas */}
<section className="nombre-pagina__hero" aria-labelledby="nombre-pagina-title">
<div className="nombre-pagina__hero-copy">
{/* Pastilla eyebrow — div plano (sin equivalente en Neus UI) */}
<div className="nombre-pagina__eyebrow-pill">
<span className="nombre-pagina__eyebrow-dot" aria-hidden="true" />
NOMBREPAGINA
<span aria-hidden="true">/</span>
PALABRACLAVE
</div>
<h1 id="nombre-pagina-title">
Titular{" "}
<span className="gradient-text">destacado</span>
</h1>
<p className="nombre-pagina__hero-sub">Tagline de la recopilación.</p>
<div className="nombre-pagina__hero-cta">
<Button label="CTA Principal" variant="solid" color="primary" onClick={() => {}} />
<Button label="CTA Secundaria" variant="outlined" color="primary" onClick={() => {}} />
</div>
</div>
<div className="nombre-pagina__hero-visual">
{/* Card destacado o panel de arte — ver dark-landing-patterns.md §4 */}
</div>
</section>
{/* Secciones de contenido de la recopilación — usa <Card variant="glass"> para tarjetas */}
{/* Ejemplo de sección de cuadrícula de artículos: */}
<section className="nombre-pagina__articles">
<div className="nombre-pagina__article-grid">
{articles?.map(article => (
<Card variant="glass" key={article.id} onClick={() => {}}>
<div className="nombre-pagina__article-inner">
<div className="nombre-pagina__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="nombre-pagina__article-dek">{article.excerpt}</p>}
</div>
</Card>
))}
</div>
</section>
{/* Sección de newsletter (si se solicita) */}
<section className="nombre-pagina__newsletter" aria-labelledby="nombre-pagina-nl-title">
<div className="nombre-pagina__nl-card">
<p className="nombre-pagina__sec-eyebrow">Newsletter</p>
<h2 id="nombre-pagina-nl-title">
Mantente al día.{" "}
<span className="gradient-text">Sin ruido.</span>
</h2>
{subscribed ? (
<p className="nombre-pagina__nl-success">✓ ¡Estás suscrito — gracias!</p>
) : (
<div className="nombre-pagina__nl-form">
<Input
name="newsletter-email"
type="email"
label="Correo electrónico"
placeholder="[email protected]"
value={email}
onChange={setEmail}
required
/>
<Button
label="Suscribirse"
type="submit"
variant="solid"
color="primary"
loading={loading}
onClick={handleSubscribe}
/>
</div>
)}
</div>
</section>
</main>
{/* Footer — enlaces usan <Link type="secondary"> */}
<footer className="nombre-pagina__footer">
<span>© {new Date().getFullYear()} NombrePagina.</span>
<div className="nombre-pagina__footer-links">
<Link type="secondary" href="/privacidad" label="Privacidad" />
<Link type="secondary" href="/contacto" label="Contacto" />
</div>
</footer>
</div>
</div>
);
};
Estructura de modo claro: Omite los divs de mesh/grid y el contenedor de contenido. Usa <Card> (sin variant) para tarjetas de contenido. Alterna fondos de sección con background: var(--color-primary-light). Usa <Link type="primary"> para enlaces principales, <Link type="secondary"> para nav/footer. Las pastillas de categoría siguen usando <Badge>.
Tile de características (ambos modos):
<Card variant="glass" icon={...} title="..." description="..." />(oscuro)<Card icon={...} title="..." description="..." />(claro)
Formulario de contacto (si se solicita): Usa campos <Input> de Neus UI + <Button type="submit">. Mismo patrón que el newsletter pero sin el wrapper de tarjeta con brillo.
NombrePagina.styles.css
Modo oscuro: Comienza con las recetas de canvas + mesh + grid + contenido de dark-surfaces.md §1. Luego añade nav glass (§3), nl-card (§4), pastilla eyebrow (§5), texto degradado (§6), panel de arte (§8 si se destaca), fila meta (§9 si hay artículos), footer (§10). Sin CSS personalizado para tarjetas — <Card variant="glass"> lo maneja. Aplica el layout de dark-landing-patterns.md.
Modo claro: Comienza con background: var(--color-white); color: var(--color-gray-900). Usa var(--color-primary-light) para fondos de secciones alternas. Sigue design-personality.md Secciones 4–5 para tipografía y espaciado.
Ambos modos:
@keyframes neus-fade-up {
from { opacity: 0; transform: translateY(16px); }
to { opacity: 1; transform: translateY(0); }
}
.nombre-pagina__hero-copy {
animation: neus-fade-up 0.5s ease both;
}
/* Utilidad de texto degradado */
.gradient-text {
background: linear-gradient(135deg, #22d3ee 0%, #818cf8 45%, #d946ef 100%);
-webkit-background-clip: text;
-webkit-text-fill-color: transparent;
background-clip: text;
}
/* Contenedores de ancho máximo */
.nombre-pagina__hero,
.nombre-pagina__articles,
.nombre-pagina__newsletter,
.nombre-pagina__footer {
max-width: min(72rem, 100%);
margin: 0 auto;
}
/* Padding de secciones */
.nombre-pagina__hero { padding: 6rem 2rem; }
.nombre-pagina__articles { padding: 6rem 2rem; }
.nombre-pagina__newsletter { padding: 5rem 2rem; }
/* Cuadrícula del hero */
.nombre-pagina__hero {
display: grid;
grid-template-columns: 1.4fr 0.6fr;
gap: 3rem;
align-items: center;
}
/* H1 */
.nombre-pagina__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;
}
/* Formulario de newsletter — fila flex */
.nombre-pagina__nl-form {
display: flex;
gap: 1rem;
align-items: flex-end;
max-width: 520px;
margin: 0 auto;
}
/* Cuadrícula de artículos */
.nombre-pagina__article-grid {
display: grid;
grid-template-columns: repeat(3, 1fr);
gap: 1.5rem;
}
/* Fila de pastillas */
.nombre-pagina__pill-row {
display: flex;
flex-wrap: wrap;
gap: 0.5rem;
margin-bottom: 0.75rem;
}
/* Responsivo */
@media (max-width: 960px) {
.nombre-pagina__hero { grid-template-columns: 1fr; }
.nombre-pagina__article-grid { grid-template-columns: 1fr; }
}
@media (max-width: 640px) {
.nombre-pagina__hero,
.nombre-pagina__articles,
.nombre-pagina__newsletter { padding: 5rem 1.25rem; }
}
Reglas Compartidas (Incrustadas)
Estas reglas están siempre activas. Se aplican incluso si no se leen los archivos
_shared/.
Salida — siempre tres archivos
Cada salida de habilidad: NombreComponente.types.ts → NombreComponente.tsx → NombreComponente.styles.css.
Sin estilos en línea (style={{}}). Sin etiquetas <style> dentro de los componentes. CSS solo en .styles.css.
Importaciones
import { Button, Card, Input, Badge, Link, Select, Modal, DataTable } from 'neus-ui';
Nunca …