@ciromaciel/components-kit

中文文档
1.8.10发布于 2026/10/31MITESM + CJS零依赖近 30 天下载 2092

Marketing site components: hero, pricing, feature splits and footer, built on Mantine.

原始使用文档
文档目录6 节
  1. Installation
  2. Quick start
  3. Fundos: dois tons de palco, um de superfície
  4. Components
  5. Development
  6. Links

@ciromaciel/components-kit

npm version npm downloads license

Marketing site components — hero, pricing, feature splits and footer — built on React and Mantine, in a monochrome, sharp-edged aesthetic.

Installation

bun add @ciromaciel/components-kit

Peers: @mantine/core, @mantine/hooks, @tabler/icons-react, react, react-dom. @mantine/charts is optional.

Import the stylesheet once, at your application entry point:

import '@ciromaciel/components-kit/style.css'

Quick start

import { MantineProvider } from '@mantine/core'
import { theme, Hero, FeatureSplit, Pricing, FAQ, Footer } from '@ciromaciel/components-kit'

function App() {
    return (
        <MantineProvider theme={theme}>
            <Hero
                subtitle="Landing pages"
                title="No code, no plugins."
                description="Your landing page live in two minutes."
                cta={{ label: 'Get started', href: '/signup' }}
            />
            <FeatureSplit /* ... */ />
            <Pricing /* ... */ />
            <FAQ /* ... */ />
            <Footer />
        </MantineProvider>
    )
}

Components are config-driven: pass data objects rather than nested JSX.

Fundos: dois tons de palco, um de superfície

Uma página usa exatamente dois tons de fundo para os seus palcos, no claro e no escuro:

TokenMantineClaroEscuro
SECTION_BACKGROUNDS.whitegray.0#FFFFFF#0B0F12 (o fundo da página)
SECTION_BACKGROUNDS.graygray.1#F9FAFB#12181D

Palco é toda faixa ou seção de largura inteira, o fundo da página, a barra do cabeçalho (inclusive o cartão fixo que fica sobre a página), o painel de menus e o menu de navegação do celular, o rodapé, as páginas legais e a 404. Os componentes recebem background="white" | "gray" e resolvem com resolveBackground. As faixas alternam os dois tons.

O white do Mantine não é tom de palco: no escuro ele é #1A2127, a superfície elevada. Serve só para o que flutua ou fica sobre um palco como cartão: cartões, modais, gavetas laterais sobre o conteúdo, menus suspensos, popovers, a caixa de um formulário dentro de uma faixa. Para cartões, use resolveCardBackground.

Uma gaveta ou modal que é palco (o menu do celular de um cabeçalho) recebe a classe rlg-stage: o tema pinta todo Paper com o white elevado direto no estilo do elemento, e a classe devolve o tom da página.

Por quê: em 21/10/2026 o cartão fixo do cabeçalho e a faixa da newsletter usavam bg="white", e no escuro a página mostrava três tons (#0B0F12, #12181D, #1A2127). Nunca bg="white" numa faixa, barra, rodapé ou página.

Components

Layout and structure — Layout, Header, Navbar, Footer, Section.

Marketing sections — Hero, SocialProof, FeatureSplit, FeaturesGrid, StatsGrid, ProductGrid, PlatformShelf, Steps, Comparison, CriteriaList, Callout, FounderCard.

Conversion — Pricing, FAQ, Testimonials, CTABanner, SecondaryCTA, LeadForm, TrustBadge, SeloExclusivo.

Status and states — StatusBoard, StatusIndicator, AuthLoader, NotFound.

Legal pages — LegalPrivacy, LegalTerms, LegalSecurity.

Primitives — SectionHeader, MediaBlock, CTAButton, CodeBlock, Wordmark, BrandLogo.

Theme, hooks and config — theme, useServiceStatus, SECTION_BACKGROUNDS, resolveBackground.

Development

bun install
bun run dev        # demo
bun run build      # build the library

MIT © Ciro Cesar Maciel

版本与发布记录

@ciromaciel/components-kit 共发布 28 个版本,首次发布于 2026/09/20;过去 12 个月发布了 28 个版本。

版本发布日期距今
1.8.10latest2026/10/319 天前
1.8.92026/10/2119 天前
1.8.82026/10/2119 天前
1.8.72026/10/1525 天前
1.8.62026/10/1526 天前
1.8.52026/10/1526 天前

关于 @ciromaciel/components-kit 的常见问题

@ciromaciel/components-kit 是什么?

Marketing site components: hero, pricing, feature splits and footer, built on Mantine.

如何安装 @ciromaciel/components-kit?

在项目目录运行 npm install @ciromaciel/components-kit,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(^18.0.0 || ^19.0.0)、react-dom(^18.0.0 || ^19.0.0)、@mantine/core(^7.0.0 || ^8.0.0)、@mantine/hooks(^7.0.0 || ^8.0.0)、@tabler/icons-react(^3.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@ciromaciel/components-kit 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/ciromaciel__components-kit 是否存在。

@ciromaciel/components-kit 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@ciromaciel/components-kit 可以商用吗?

@ciromaciel/components-kit 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@ciromaciel/components-kit 的下载量有多少?

根据 npm 官方下载统计,@ciromaciel/components-kit 在 2026/10/10 – 2026/11/08 这 30 天内被下载 2,092 次,日均约 70 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@ciromaciel/components-kit 还在维护吗?

最新版本 1.8.10 发布于 2026/10/31(9 天前);至今共发布 28 个版本,其中过去 12 个月发布了 28 个;首次发布于 2026/09/20。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。