stitch-flutter
暂无简介
- License 许可
- MIT
- 最近更新
- 2026-06-13
- Stars
- ★ 3
- Forks
- 1
02 资源文件 2
- 参考文档references/flutter-html-glossary.md5.1 KB
- 参考文档references/tailwind-to-flutter.md17.1 KB
03 SKILL.md 正文
Stitch Flutter — Tailwind HTML → Pixel-Perfect Flutter
Convert HTML + Tailwind CSS design mockups into production-ready Flutter widgets. AI produces beautiful Tailwind — this skill maps every utility class to its exact Flutter equivalent.
Design Philosophy
- AI generates Tailwind HTML — what it's best at, highest design quality
- Minimal
data-flutterhints — only for Flutter-specific widgets (Scaffold, AppBar, Hero, CachedImage) that have no HTML equivalent - Tailwind classes = Flutter styling — every utility class maps to an exact Flutter property via
references/tailwind-to-flutter.md - CSS is for browser preview — the converter reads Tailwind classes +
data-flutterattributes, not computed CSS
Inputs
.stitch/designs/{screenId}/design.html— Tailwind HTML mockup.stitch/system/DESIGN.md— Design system specification
Output
lib/screens/{snake_id}/{snake_id}_screen.dart— Flutter screen widget
Conversion Procedure
Step 1: Parse HTML Structure
Read the HTML and identify:
data-flutterattributes → Flutter-specific widgets (see glossary)- Tailwind classes on each element → styling properties (see
tailwind-to-flutter.md) - HTML element type (
div,button,img,span,nav,header) → widget type hints - Text content →
Text()widget strings aria-*attributes →Semantics()widgets- Inline SVG icons →
Icon(Icons.{name})orSvgPicture.string()
Step 2: Determine Widget Type
For each element, use this decision tree:
- Has
data-flutter="scaffold"? →Scaffold() - Has
data-flutter="app-bar"? →AppBar() - Has
data-flutter="bottom-nav"? →NavigationBar() - Has
data-flutter="hero"? →Hero(tag: ...) - Has
data-flutter="cached-image"? →CachedNetworkImage() - Is
<button>? → Determine button type from Tailwind classes - Is
<img>? →Image.network()orCachedNetworkImage() - Is text element (
<h1>-<h6>,<p>,<span>)? →Text() - Has
flex flex-col? →Column() - Has
flex(default row)? →Row() - Has
grid? →GridView() - Has
overflow-y-auto? →SingleChildScrollView() - Has
overflow-x-auto? →SingleChildScrollView(scrollDirection: Axis.horizontal) - Has
relativewithabsolutechildren? →Stack()+Positioned() - Has
bg-*+rounded-*? →DecoratedBox()orContainer() - Has only
p-*? →Padding() - Has only size classes? →
SizedBox()
Step 3: Extract Styling from Tailwind Classes
For each Tailwind class, look up the Flutter equivalent in tailwind-to-flutter.md:
<div class="flex flex-col gap-4 p-4 bg-slate-900 rounded-xl shadow-lg">
Parses to:
flex flex-col→Column()gap-4→ 16px spacing between childrenp-4→Padding(padding: EdgeInsets.all(16))bg-slate-900→color: Color(0xFF0F172A)rounded-xl→borderRadius: BorderRadius.circular(12)shadow-lg→boxShadow: [BoxShadow(...)]
Result:
Container(
padding: const EdgeInsets.all(16),
decoration: BoxDecoration(
color: const Color(0xFF0F172A),
borderRadius: BorderRadius.circular(12),
boxShadow: const [
BoxShadow(color: Color(0x1A000000), blurRadius: 15, offset: Offset(0, 10)),
],
),
child: Column(
children: [
child1,
const SizedBox(height: 16),
child2,
],
),
)
Step 4: Handle Text
<span class="text-lg font-semibold text-white">Novel Title</span>
→ fontSize: 18, fontWeight: FontWeight.w600, color: Colors.white
Text(
'Novel Title',
style: TextStyle(fontSize: 18, fontWeight: FontWeight.w600, color: Colors.white),
)
Step 5: Handle Buttons
| Tailwind Pattern | Flutter Button |
|---|---|
Prominent bg-{color} + text color |
FilledButton or ElevatedButton |
border + no fill |
OutlinedButton |
| Text only, no border/fill | TextButton |
| Icon only, circular | IconButton |
Step 6: Handle Images
<img class="w-20 h-28 rounded-lg object-cover" src="..." />
→ ClipRRect + CachedNetworkImage(width: 80, height: 112, fit: BoxFit.cover)
Step 7: Handle data-flutter Attributes
Only for Flutter-specific widgets with no HTML equivalent:
data-flutter |
Flutter Widget | Extra Attributes |
|---|---|---|
scaffold |
Scaffold() |
— |
app-bar |
AppBar() |
— |
bottom-nav |
NavigationBar() |
— |
nav-destination |
NavigationDestination() |
data-icon, data-label |
fab |
FloatingActionButton() |
data-icon |
hero |
Hero() |
data-tag |
cached-image |
CachedNetworkImage() |
— |
sliver-app-bar |
SliverAppBar() |
data-expanded-height, data-pinned |
custom-scroll |
CustomScrollView() |
— |
sliver-list |
SliverList() |
— |
tab-bar |
TabBar() |
— |
tab-view |
TabBarView() |
— |
bottom-sheet |
showModalBottomSheet() |
— |
safe-area |
SafeArea() |
— |
refresh |
RefreshIndicator() |
— |
Step 8: Generate Dart File
import 'package:flutter/material.dart';
import 'package:cached_network_image/cached_network_image.dart';
class {WidgetName}Screen extends StatelessWidget {
const {WidgetName}Screen({super.key});
@override
Widget build(BuildContext context) {
return Scaffold(
// ... converted from Tailwind HTML
);
}
}
Step 9: Update Router & Verify
- Add route to
lib/router/app_router.dart dart format lib/screens/{snake_id}/dart analyze --no-fatal-infos lib/screens/{snake_id}/
Worked Example
Input (Tailwind HTML)
<div data-flutter="scaffold" class="flex flex-col min-h-screen bg-slate-950">
<header data-flutter="app-bar" class="flex items-center h-14 px-2 bg-slate-900/80 backdrop-blur-lg">
<button class="w-10 h-10 flex items-center justify-center rounded-full" aria-label="Back">
<svg><!-- arrow_back --></svg>
</button>
<h1 class="text-lg font-semibold text-white ml-3">Home</h1>
</header>
<main class="flex-1 overflow-y-auto">
<div class="flex flex-col gap-6 p-4">
<h2 class="text-xl font-bold text-white">Continue Reading</h2>
<div class="bg-slate-800 rounded-2xl p-4 shadow-lg">
<div class="flex gap-3">
<img data-flutter="cached-image" class="w-16 h-24 rounded-lg object-cover"
src="https://picsum.photos/seed/n1/100/150" />
<div class="flex flex-col flex-1 gap-1">
<span class="text-base font-semibold text-white">The Dragon's Apprentice</span>
<span class="text-sm text-slate-400">Chapter 42 of 120</span>
<div class="h-1.5 bg-slate-700 rounded-full mt-1">
<div class="h-full w-[35%] bg-amber-500 rounded-full"></div>
</div>
</div>
</div>
</div>
</div>
</main>
<nav data-flutter="bottom-nav" class="flex justify-around h-14 bg-slate-900 border-t border-slate-800">
<button data-flutter="nav-destination" data-icon="home" data-label="Home"
class="flex flex-col items-center gap-0.5 text-amber-500">
<svg><!-- home --></svg><span class="text-xs">Home</span>
</button>
<button data-flutter="nav-destination" data-icon="search" data-label="Browse"
class="flex flex-col items-center gap-0.5 text-slate-500">
<svg><!-- search --></svg><span class="text-xs">Browse</span>
</button>
</nav>
</div>
Output (Flutter)
Scaffold(
backgroundColor: const Color(0xFF020617),
appBar: AppBar(
backgroundColor: const Color(0xFF0F172A).withValues(alpha: 0.8),
leading: IconButton(
icon: const Icon(Icons.arrow_back), onPressed: () {}, tooltip: 'Back',
),
title: const Text('Home',
style: TextStyle(fontSize: 18, fontWeight: FontWeight.w600, color: Colors.white),
),
),
body: SingleChildScrollView(
child: Padding(
padding: const EdgeInsets.all(16),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
const Text('Continue Reading',
style: TextStyle(fontSize: 20, fontWeight: FontWeight.w700, color: Colors.white),
),
const SizedBox(height: 24),
Container(
padding: const EdgeInsets.all(16),
decoration: BoxDecoration(
color: const Color(0xFF1E293B),
borderRadius: BorderRadius.circular(16),
boxShadow: const [BoxShadow(color: Color(0x1A000000), blurRadius: 15, offset: Offset(0, 10))],
),
child: Row(children: [
ClipRRect(
borderRadius: BorderRadius.circular(8),
child: CachedNetworkImage(
imageUrl: 'https://picsum.photos/seed/n1/100/150',
width: 64, height: 96, fit: BoxFit.cover,
),
),
const SizedBox(width: 12),
Expanded(child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
const Text("The Dragon's Apprentice",
style: TextStyle(fontSize: 16, fontWeight: FontWeight.w600, color: Colors.white)),
const SizedBox(height: 4),
const Text('Chapter 42 of 120',
style: TextStyle(fontSize: 14, color: Color(0xFF94A3B8))),
const SizedBox(height: 4),
ClipRRect(
borderRadius: BorderRadius.circular(9999),
child: const SizedBox(height: 6,
child: LinearProgressIndicator(value: 0.35,
backgroundColor: Color(0xFF334155),
valueColor: AlwaysStoppedAnimation(Color(0xFFF59E0B)))),
),
],
)),
]),
),
],
),
),
),
bottomNavigationBar: NavigationBar(
backgroundColor: const Color(0xFF0F172A),
selectedIndex: 0,
destinations: const [
NavigationDestination(icon: Icon(Icons.home), label: 'Home'),
NavigationDestination(icon: Icon(Icons.search), label: 'Browse'),
],
),
)
Cross-Reference
- Tailwind → Flutter:
references/tailwind-to-flutter.md— complete class-by-class mapping data-flutterhints:references/flutter-html-glossary.md— Flutter-specific attributes- HTML generation:
stitch-generate/SKILL.md— how to produce Tailwind HTML
04 同仓库更多 Skills
hello-checker
Use this skill when asked to "verify", "check", or "validate" a file's existence and content. It provides a reliable workflow for confirming files meet their spec.
ask-skill
暂无简介
html-review-artifact
Framework-wide guidance for crafting polished human-review artifacts as markdown or HTML
converge-planning
Design a Converge playbook end-to-end. Use when the user says "plan a project", "design a playbook", "decompose into tasks", "scaffold a Converge workflow", "onboard to Converge", or asks how to write TASK.md / playbook.yml. Two entry points: plan a new playbook or update an existing one. Hand off to `/converge-control` after producing the playbook structure.
converge-control
Operate a Converge playbook end-to-end — start runs, monitor progress, narrow failures with `--select`, inspect runtime state, validate definitions, surgically reset subtrees, and stop stuck or orphaned runs. Use this skill whenever the user says "run my playbook", "execute this", "monitor the run", "converge failed", "the run is stuck", "retry failures", "babysit this playbook", "what's the status?", "show me the gantt", or asks how to use `converge run` / `--select` / `inspect` / `doctor` / `clean` / `stop`. Also use it for `HTTP 401` / `Invalid API key` failures on the first task — those are environment-not-playbook problems — and for any post-run cleanup work. Hand off to `converge-planning` if the user wants to design or restructure the playbook itself.
repair-taskts
Fix task.ts definition issues — Seed syntax, missing .build(), empty checks, import errors, TypeScript errors