@flashcatcloud/meow-ui

Meow UI is a public ESM React component package for Tailwind CSS v3 hosts.

The compiled distribution and accompanying materials are licensed under Apache-2.0. See NOTICE and THIRD_PARTY_LICENSES.md for attribution and distribution boundaries.

Supported hosts

• Tailwind CSS ^3.4 only.
• React 17, React 18, and React 19 for the base package entrypoint.
• Tailwind v4 and hosts that do not use Tailwind are outside this package's support boundary.

@flashcatcloud/meow-ui/Command and @flashcatcloud/meow-ui/advanced/Conditions require React 18 or newer. They use optional peers (cmdk and Zustand 5 respectively), so React 17 hosts must not import those entrypoints.

Install

Pin the public package to the released version:

npm install @flashcatcloud/[email protected]

The host application owns peer dependencies. npm may install compatible peers automatically, but it must not result in a second React, Tailwind, or shared UI runtime. Install and resolve the peer versions in the host; Ant Design is an optional peer and is only needed when importing @flashcatcloud/meow-ui/adapters/antd.

Use the public ESM entrypoints

import { Button, cn } from "@flashcatcloud/meow-ui"
import { Conditions } from "@flashcatcloud/meow-ui/advanced/Conditions"
import { DataTable } from "@flashcatcloud/meow-ui/advanced/DataTable"

Only the documented package entrypoints are public. Do not import basic/*, form/*, source files, or other deep paths.

Add the styles and Tailwind scan path

Import the styles once in the host's global CSS, before Tailwind's three v3 directives:

@import "@flashcatcloud/meow-ui/styles";

@tailwind base;
@tailwind components;
@tailwind utilities;

Configure the host's Tailwind v3 content to scan the installed, compiled ESM package:

/** @type {import('tailwindcss').Config} */
module.exports = {
  content: [
    "./src/**/*.{js,ts,jsx,tsx}",
    "./node_modules/@flashcatcloud/meow-ui/**/*.{js,mjs}",
  ],
  theme: {
    extend: {},
  },
  plugins: [],
};

@flashcatcloud/meow-ui/styles is the only public stylesheet entrypoint. It provides Meow UI tokens, global base rules, and required keyframes. It does not ship a complete generated Tailwind utility stylesheet or a Tailwind preset.

The host keeps ownership of its Tailwind theme, plugins, application content paths, and any important strategy. Keep those choices in the host configuration; do not expect this package to replace or override them.

Consumer guidance

For AI agents and teams that want the package rules in their repository, read guidance/SKILL.md. It is the public consumer-facing guide and deliberately excludes maintainer workflows, test templates, and release procedures.