Communitygithub.com

Neus Landing Genérica

Gera uma landing page de propósito geral e flexível com seção hero, seções de conteúdo e CTA. Produz um arquivo .tsx usando os componentes Button, Card e Link do Neus UI. Sem AppTemplate.

O que é Neus Landing Genérica?

Esta skill é projetada para gerar landing pages de uso geral que não se enquadram no perfil de produtos SaaS. Ela produz três arquivos: um arquivo de tipos TypeScript (.types.ts), o componente React principal (.tsx) e sua folha de estilos CSS (.styles.css). A página resultante inclui uma seção hero com título e subtítulo, seções de conteúdo flexíveis (como grade de artigos, boletim informativo, etc.) e chamadas para ação (CTAs) primária e secundária. A skill utiliza exclusivamente componentes do Neus UI (Button, Card, Link, Input, Badge) e adere a regras rígidas de design, como a proibição do AppTemplate e a definição de um Diretivo Visual que orienta paleta de cores, personalidade (Aéreo, Cinético, Estruturado, Em Camadas) e modo (claro ou escuro). É ideal para portfólios, páginas pessoais, landing pages de empresas, eventos e agências, onde o foco não é um produto SaaS.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que Neus Landing Genérica faz?

Gera uma landing page de propósito geral com seção hero, seções de conteúdo e CTA. Adapta-se ao objetivo do usuário.

IMPORTANTE: Sem AppTemplate. Página pública.


Antes de começar

A seção "Regras Compartilhadas" abaixo está sempre ativa. Além disso, leia TODAS estas regras antes da Fase 0:

  • .agents/skills/_shared/anti-slop.md — regras de qualidade obrigatórias (seção "Marketing Pages")
  • .agents/skills/_shared/prop-constraints.md — props proibidas e componentes inexistentes
  • .agents/skills/_shared/component-catalog.md — seções Button, Card, Link, Input
  • .agents/skills/_shared/design-personality.md — eixos de personalidade, formato DIRETIVA VISUAL, Seção 9 receitas de superfície para modo escuro
  • .agents/skills/_shared/dark-surfaces.md — receitas CSS para modo escuro (leia quando Modo: escuro)
  • .agents/skills/_shared/light-surfaces.md — receitas CSS para modo claro (leia quando Modo: claro)
  • .agents/skills/_shared/checklist.md — portões P0/P1/P2
  • .agents/skills/_shared/layout-patterns.md — padrões de landing (linha de estatísticas, divisão cabeçalho-seção, pílula de sobrancelha do hero, navegação adaptável ao modo)
  • .agents/skills/neus-landing-generic/references/dark-landing-patterns.md — anatomia do layout da seção e padrões JSX para landings escuras

Fase 0 — Coletar Dados

Faça estas perguntas ao usuário e aguarde a resposta completa antes de prosseguir:


  1. Que tipo de página é? (portfólio, empresa, evento, agência, blog, pessoal, outro)
  2. Nome da página / marca
  3. Título principal (H1) — pode incluir uma palavra de destaque para efeito gradiente
  4. Subtítulo ou tagline
  5. Seções a incluir (liste exatamente — não adicione mais)
  6. CTA primário: rótulo + ação
  7. CTA secundário (opcional): rótulo + ação
  8. Cor do tema principal (hex ou descrição)
  9. Modo: claro ou escuro?
  10. Personalidade: limpo/aéreo, editorial/em camadas, ousado/cinético, ou estruturado? (se não tiver certeza, descreva a vibe)
  11. Inclui formulário de contato ou boletim informativo? (sim/não — especifique qual)

Fase 1 — Resolução Visual

Antes de escrever qualquer código, resolva a DIRETIVA VISUAL a partir das respostas da coleta.

Mapeamento de paleta:

  • Cores vibrantes / energéticas → Vibrante
  • Neutro / sóbrio / tons de cinza → Neutro
  • Azuis / verdes corporativos → Corporativo
  • Roxo / rosa / criativo → Criativo

Mapeamento de personalidade da Q10:

  • limpo / minimalista / aéreo → Aéreo
  • editorial / em camadas / assimétrico → Em Camadas
  • ousado / forte / cinético → Cinético
  • estruturado / formal / denso em dados → Estruturado

Construa este bloco e leve-o para a Fase 2:

DIRETIVA VISUAL:
- Paleta: [Vibrante / Neutro / Corporativo / Criativo]
- Personalidade: [Cinético / Aéreo / Estruturado / Em Camadas]
- Modo: [claro / escuro]
- Animação: [neus-fade-up em .hero-copy / nenhum]
- Layout: [hero 2 colunas assimétrico 1.4fr/0.6fr / hero centralizado]
- H1: [clamp(2.5rem,6vw,4rem) peso-800 / clamp(2rem,4vw,3rem) peso-700]
- Texto gradiente: [sim — palavra de destaque: "[palavra]" / não]
- Superfícies: [vidro (dark-surfaces.md) / padrão var(--color-white)]
- Nav: [vidro fixo / padrão fixo / nenhum]

Regra de modo escuro: Se Modo: escuro, TODAS as superfícies usam as receitas de dark-surfaces.md. Nunca use var(--color-white) como fundo de página ou seção. Use <Card variant="glass"> para cartões de conteúdo — esta é a superfície de vidro do Neus UI. Nunca a substitua por uma <div> bruta + CSS personalizado.

Regra de modo claro: Se Modo: claro, use <Card> do Neus UI para cartões de conteúdo, var(--color-primary-light) para fundos de seção alternados, var(--color-white) para a raiz da página.


Fase 2 — Verificação P0

  • Seções de saída == seções da coleta (Q5). Zero extras.
  • Nenhum texto inventado — todo o texto vem da coleta ou é explicitamente orientado por props
  • Sem AppTemplate ou barra lateral
  • DIRETIVA VISUAL construída e levada adiante
  • Modo escuro: todas as superfícies usam receitas de vidro, sem fundos var(--color-white)
  • Modo claro: <Card> do Neus UI usado para conteúdo, primary-light para seções alternadas

Fase 3 — Gerar Artefato

Produza três arquivos nesta ordem: PageName.types.ts → PageName.tsx → PageName.styles.css.


PageName.types.ts

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

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

// Adicione tipos específicos de seção derivados apenas da coleta
export type Article = {
  id: string;
  title: string;
  href?: string;
  excerpt?: string;
  author?: string;
  meta?: string;
  categories?: string[];
};

// Categoria → mapeamento de cor de Badge (modo escuro: 4 cores visualmente distintas)
export const BADGE_COLOR: Record<string, BadgeColor> = {
  systems:  "primary",
  design:   "error",
  craft:    "neutral",
  tools:    "success",
  featured: "primary",
};

export type PageNameProps = {
  // Props apenas para dados vindos de fora (lista de artigos, manipuladores de formulário, etc.)
  // Texto de marketing estático é codificado no componente — nunca como prop
};

PageName.tsx

Estrutura de modo escuro — uso correto de componentes:

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

export const PageName = ({ articles, onSubscribe }: PageNameProps) => {
  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">
      {/* Camadas de fundo decorativas — aria-hidden, sem interação */}
      <div className="page-name__mesh" aria-hidden="true" />
      <div className="page-name__grid" aria-hidden="true" />

      <div className="page-name__content">
        {/* Nav fixa de vidro — links usam <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">PageName</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="Subscribe" variant="solid" color="primary" size="small" onClick={() => {}} />
        </nav>

        <main>
          {/* Hero — 2 colunas assimétrico */}
          <section className="page-name__hero" aria-labelledby="page-name-title">
            <div className="page-name__hero-copy">
              {/* Pílula de sobrancelha — div bruta (sem equivalente no Neus UI) */}
              <div className="page-name__eyebrow-pill">
                <span className="page-name__eyebrow-dot" aria-hidden="true" />
                PAGENAME
                <span aria-hidden="true">/</span>
                KEYWORD
              </div>
              <h1 id="page-name-title">
                Headline{" "}
                <span className="gradient-text">accent</span>
              </h1>
              <p className="page-name__hero-sub">Tagline da coleta.</p>
              <div className="page-name__hero-cta">
                <Button label="Primary CTA" variant="solid" color="primary" onClick={() => {}} />
                <Button label="Secondary CTA" variant="outlined" color="primary" onClick={() => {}} />
              </div>
            </div>
            <div className="page-name__hero-visual">
              {/* Cartão de destaque ou painel de arte — veja dark-landing-patterns.md §4 */}
            </div>
          </section>

          {/* Seções de conteúdo da coleta — use <Card variant="glass"> para cartões */}
          {/* Exemplo de seção de grade de artigos: */}
          <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>

          {/* Seção de boletim informativo (se solicitado) */}
          <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">
                Stay in the loop.{" "}
                <span className="gradient-text">No noise.</span>
              </h2>
              {subscribed ? (
                <p className="page-name__nl-success">✓ You're subscribed — thanks!</p>
              ) : (
                <div className="page-name__nl-form">
                  <Input
                    name="newsletter-email"
                    type="email"
                    label="Email"
                    placeholder="[email protected]"
                    value={email}
                    onChange={setEmail}
                    required
                  />
                  <Button
                    label="Subscribe"
                    type="submit"
                    variant="solid"
                    color="primary"
                    loading={loading}
                    onClick={handleSubscribe}
                  />
                </div>
              )}
            </div>
          </section>
        </main>

        {/* Rodapé — links usam <Link type="secondary"> */}
        <footer className="page-name__footer">
          <span>© {new Date().getFullYear()} PageName.</span>
          <div className="page-name__footer-links">
            <Link type="secondary" href="/privacy" label="Privacy" />
            <Link type="secondary" href="/contact" label="Contact" />
          </div>
        </footer>
      </div>
    </div>
  );
};

Estrutura de modo claro: Omita as divs mesh/grid e o wrapper de conteúdo. Use <Card> (sem variant) para cartões de conteúdo. Alterne fundos de seção com background: var(--color-primary-light). Use <Link type="primary"> para links primários, <Link type="secondary"> para navegação/rodapé. As pílulas de categoria ainda usam <Badge>.

Bloco de recurso (ambos os modos):

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

Formulário de contato (se solicitado): Use campos <Input> do Neus UI + <Button type="submit">. Mesmo padrão do boletim informativo, mas sem o wrapper de cartão brilhante.


PageName.styles.css

Modo escuro: Comece com as receitas de canvas + mesh + grid + conteúdo de dark-surfaces.md §1. Em seguida, adicione nav de vidro (§3), nl-card (§4), pílula de sobrancelha (§5), texto gradiente (§6), painel de arte (§8 se em destaque), linha de metadados (§9 se artigos), rodapé (§10). Sem CSS de cartão personalizado — <Card variant="glass"> cuida disso. Aplique layout de dark-landing-patterns.md.

Modo claro: Comece com background: var(--color-white); color: var(--color-gray-900). Use var(--color-primary-light) para fundos de seção alternados. Siga design-personality.md Seção 4–5 para tipografia e espaçamento.

Ambos os modos:

@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;
}

/* Utilitário de texto gradiente */
.gradient-text {
  background: linear-gradient(135deg, #22d3ee 0%, #818cf8 45%, #d946ef 100%);
  -webkit-background-clip: text;
  -webkit-text-fill-color: transparent;
  background-clip: text;
}

/* Contêineres de largura máxima */
.page-name__hero,
.page-name__articles,
.page-name__newsletter,
.page-name__footer {
  max-width: min(72rem, 100%);
  margin: 0 auto;
}

/* Preenchimento de seção */
.page-name__hero       { padding: 6rem 2rem; }
.page-name__articles   { padding: 6rem 2rem; }
.page-name__newsletter { padding: 5rem 2rem; }

/* Grade do hero */
.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;
}

/* Formulário do boletim informativo — linha flexível */
.page-name__nl-form {
  display: flex;
  gap: 1rem;
  align-items: flex-end;
  max-width: 520px;
  margin: 0 auto;
}

/* Grade de artigos */
.page-name__article-grid {
  display: grid;
  grid-template-columns: repeat(3, 1fr);
  gap: 1.5rem;
}

/* Linha de pílulas */
.page-name__pill-row {
  display: flex;
  flex-wrap: wrap;
  gap: 0.5rem;
  margin-bottom: 0.75rem;
}

/* Responsivo */
@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; }
}

Regras Compartilhadas (Incorpora das)

Estas regras estão sempre ativas. Elas se aplicam mesmo se os arquivos _shared/ não forem lidos.

Saída — sempre três arquivos

Cada saída da skill: ComponentName.types.ts → ComponentName.tsx → ComponentName.styles.css. Sem estilos em linha (style={{}}). Sem tags <style> dentro dos componentes. CSS apenas em .styles.css.

Importações

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

Nunca ...

[truncado para tradução]

Individual skills in this repo

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

Habilidades Relacionadas