Skip to content

About

Make your Flutter UI stop looking AI-generated. Agent skill + zero-dependency scanner with a 0-100 slop score.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

 

History

2 Commits

Folders and files

Repository files navigation

The same habit tracker screen: 72/100 slop score before, 0/100 after flutter-unslop

HTML mockups of examples/before and examples/after. Flutter screenshots coming.

flutter-unslop

Make your Flutter UI stop looking AI-generated.
An agent skill plus a zero-dependency scanner that gives your app a slop score from 0 to 100, and the fixes.

tests zero dependencies Flutter MIT


npx github:MBotirjonDev/flutter-unslop ./lib
  Slop score  ██████████████░░░░░░  72/100  pure default: it looks generated

  Template colors U01 · +12
     main.dart:16  seedColor: Colors.deepPurple
     → Pick a seed color that belongs to this product (ColorScheme.fromSeed with your own color), not the flutter create default.
  ...

You know the look

The flutter create purple. A gradient header. "Welcome back, John Doe 👋". Shadowed cards in a column, an emoji in each one, and a different font size on every line. Every choice is defensible on its own. Together they say nobody decided anything.

flutter-unslop finds those defaults in your Dart code, scores them, and (as an agent skill) redesigns the screen with a real direction: a purpose, a tone and one signature detail.

The 13 tells

Rule Weight Tell Fix
U01 12 Template colors (Colors.deepPurple seed) Your own seed color in ColorScheme.fromSeed
U02 12 Purple-to-blue gradient Flat tinted surfaces, or two neighbors of your primary
U03 10 Colors hard-coded in widgets Colors in ThemeData / ColorScheme, read with Theme.of(context)
U04 10 Ad-hoc TextStyle sizes TextTheme roles, 4 sizes per screen
U05 8 Spacing off the 4 px grid 4, 8, 12, 16, 24, 32, 48
U06 6 Too many corner radii One radius family set in component themes
U07 8 Cards and shadows on everything Spacing, dividers or a tinted surface
U08 6 Emoji used as icons One icon set
U09 6 Placeholder copy ("John Doe", "Get Started") The real words
U10 5 Pure black on pure white Tinted neutrals from the scheme
U11 6 No dark theme darkTheme from the same seed
U12 6 Loading without error or empty states A designed state with one action
U13 5 Grey text by opacity or Colors.grey onSurfaceVariant / outline

Weights add up to 100. Large projects need more hits for the same score, so one stray hard-coded color in a 200-file app does not dominate. --list-rules prints the full text.

Scores of real apps

App Score
flutter/samples: compass_app 0
gskinnerTeam/flutter-wonderous-app 3
localsend/localsend 10
flutter/samples: material_3_demo 14
examples/before (what an agent writes by default) 72
examples/after (the same screen after this skill) 0

Hand-designed apps score low, which is the point. While testing on these apps I narrowed the gradient rule after it flagged a purple tonal brand gradient in compass_app as slop.

Use it as an agent skill

git clone https://github.com/MBotirjonDev/flutter-unslop
cp -r flutter-unslop/skills/flutter-unslop ~/.claude/skills/

Then ask: "This screen looks AI-generated, fix it" or "Design review my Flutter UI." The agent runs the scanner, writes a three-line direction (purpose, tone, signature detail), then changes the theme first and the widgets second, and runs the scanner again.

Works with any agent that reads SKILL.md: Claude Code, Codex, Cursor, OpenCode and others.

Use it in CI

- uses: actions/setup-node@v5
  with: { node-version: 22 }
- run: npx -y github:MBotirjonDev/flutter-unslop lib --max-score 30

--max-score exits with 1 when the score is higher. --json gives machine-readable output.

Honest limits

  • It is a static scan of Dart source. It does not render your app. It cannot see a beautiful screen built from defaults or an ugly one built from tokens.
  • The score is a smoke detector, not a grade. A low score means none of the common tells, not that the design is good.
  • The example apps have not been compiled yet (the build environment had no Flutter SDK). The images above are HTML mockups of them. Real screenshots will replace them.

Credits

The idea comes from heydamir/unslop, which does this for web UI. flutter-unslop is a separate implementation for Flutter, with its own rules and scanner.

More from me


MIT · made by Botirjon in Uzbekistan

About

Make your Flutter UI stop looking AI-generated. Agent skill + zero-dependency scanner with a 0-100 slop score.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages