weapp-tailwindcss-setup

A setup guide for adding weapp-tailwindcss v5 and Tailwind CSS 4 to projects that build WeChat Mini Programs and other targets. It covers common frameworks and build tools.

In plain words
What is it for?
Configure Tailwind CSS for uni-app, Taro, Mpx, native Mini Programs, Vite, Webpack, Rspack, Gulp, or a standalone CLI, then verify development and target builds.
Why use it?
It helps choose the correct integration point and avoid problems such as duplicate Tailwind processing, incomplete source scanning, or unsupported project types.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/sonofmagic/weapp-tailwindcss/weapp-tailwindcss-setup
Any agent
npx skills add sonofmagic/weapp-tailwindcss --skill weapp-tailwindcss-setup
Clone the repo
git clone --depth 1 https://github.com/sonofmagic/weapp-tailwindcss

Made for: Claude Code, Codex.

Per session 128 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 744 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00128 $0.00744
Opus 5 $0.00064 $0.00372
Sonnet 5 $0.00026 $0.00149
Haiku 4.5 $0.00013 $0.00074

Measured yesterday against content hash ab9d35cbfcc5, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

weapp-tailwindcss-setup scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

Copies of this mod

1 near-identical copy found in the catalogue:

skills/weapp-tailwindcss-setup/SKILL.md · 35 lines

What it actually says

weapp-tailwindcss setup

基于用户真实项目生成最小、可复制、可验证的接入配置。

工作流

  1. 读取项目的 package.json、Tailwind CSS 入口、框架配置和实际运行脚本。
  2. 确认框架、构建器、目标端、包版本、Node 版本;HBuilderX 项目同时确认 IDE 版本。
  3. 读取 references/framework-matrix.md,选择唯一匹配的注册位置和入口模式。
  4. 如果用户只需要单个 CSS 入口、stdin/stdout 或 canonicalize,选择独立 CLI;完整小程序项目继续使用 bundler 集成。
  5. bundler 项目先建立 Tailwind CSS 4 纯 CSS 入口,再让框架实际引入该入口,最后配置绝对路径 cssEntries
  6. 只注册一次 WeappTailwindcss。保留业务 PostCSS 插件,但不要在同一次受管构建中再注册 Tailwind 官方生成插件。
  7. 多端项目保留 H5/Web 链路,让插件自动选择目标;只有明确完全跳过插件的独立目标才使用 disabled
  8. 运行开发态和目标端构建,用新增任意值 class 验证生成、转译与 HMR。

配置原则

  • 当前包 manifest 的 Node engine 是 ^22.18.0 || >=24.11.0;不要把旧的 >=22.12.0 文案当成当前精确约束。
  • HBuilderX 使用当前依赖时至少为 5.11,并用绝对路径避免 IDE 改变 process.cwd() 的影响。
  • Tailwind CSS 入口不要直接放在 Sass/Less/Stylus 文件中。
  • 扫描只覆盖业务源码,默认排除 node_modulesdistunpackage;uni-app 还应避免无差别扫描 uni_modules
  • 普通业务项目优先使用官方 bundler 插件;只有自研构建器才转到 $weapp-tailwindcss-custom-build
  • Expo/React Native 转到 $weapp-tailwindcss-react-native,不要套用小程序 bundler 配置。
  • ReactLynx/Rspeedy 转到 $weapp-tailwindcss-lynx,不要套用 React Native manifest 或小程序 class 转义。
  • CLI 默认 --target web--target weapp 只对生成 CSS 做小程序兼容转换,不处理模板、脚本或已有 WXSS。

输出要求

输出框架与目标端结论、安装命令、逐文件完整配置、运行命令、预期产物和回滚点。不要只给选项列表。

Files

What ships with it

2 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 35 lines · 128 tokens per session scan A ab9d35cbfcc5

Subscribe to this mod's changes

weapp-tailwindcss-setup is a skill published in the GitHub repository sonofmagic/weapp-tailwindcss (1,853 stars, last pushed 2d ago), licensed MIT. It adds 128 tokens to every session and 744 once invoked, about $0.0006 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

uniwind

Uniwind — Tailwind CSS v4 styling for React Native. Use when adding, building, or debugging components in a React Native project that uses Uniwind classNames. Covers setup, Metro config, global.css, theming, className props, accent- color props, platform/data/state/responsive variants, CSS variables, custom utilities…

uni-stack/uniwind · 130 tokens

weapp-vite-best-practices

面向采用 weapp-vite 项目布局仓库或已安装 weapp-vite 依赖项目的工程化实践手册,覆盖 vite.config.ts 的 weapp 配置、内置 i18n、自动路由、routeRules/layout、buildScope、自动导入组件、分包、npm、六平台单目标构建、受管 TypeScript、HMR、sourcemap、prepare、MCP、Web runtime、lib mode、worker、AI skills,以及与 weapp-ide-cli 的命令治理边界。.

weapp-vite/weapp-vite · 134 tokens

native-to-weapp-vite-wevu-migration

面向原生微信、支付宝、抖音等小程序渐进迁移到 weapp-vite + 原生 或继续升级到 weapp-vite + wevu + Vue SFC 的结构化工作流,覆盖六平台单目标构建、原生扩展名保留、Web 联调边界、路线选择、工具链接入、SFC 试点、响应式升级与可回滚验证。.

weapp-vite/weapp-vite · 106 tokens

docs-and-website-sync

面向 weapp-vite monorepo 的文档、website 与公开 skills 同步工作流。适用于源码能力变化后同步配置、CLI、React/Wevu/Vue SFC、多平台、mpcore、README、packaged docs、脚手架 AGENTS.md、AI skills 元数据和触发回归入口。.

weapp-vite/weapp-vite · 79 tokens

weapp-vite-vue-sfc-best-practices

面向使用 weapp-vite 的小程序项目的 Vue SFC 实践手册,覆盖 script setup、纯模板 SFC、JSON 宏、definePageMeta/layout、defineModel、usingComponents、内置 i18n Behavior、JSX/TSX script block、模板指令兼容、多平台 SFC、.weapp-vite 类型支持文件与受管 prepare 工作流。.

weapp-vite/weapp-vite · 107 tokens

release-and-changeset-best-practices

面向 weapp-vite monorepo 的 repoctl release、pnpm change intent 与 issue 交付工作流。适用于 weapp-vite、wevu、@weapp-vite/react、mpcore、模板、公开 skills 或 AI 合约变更,判断 change intent、create-weapp-vite 联动、跨平台验证,以及从 issue worktree 到中文 PR/CI 的交付闭环。.

weapp-vite/weapp-vite · 106 tokens