If you’ve ever used AI to build a landing page, app, or slide deck, you’ve probably hit the same wall every other builder hits. The first screen looks amazing. The next five look like every other AI-generated site on the internet.
Purple gradients. Generic buttons. The same hero section you’ve seen a thousand times. There’s now a better way to fix this, and it’s called Design.md — a portable blueprint that lets you carry the soul of a design system into any AI tool you use, so every page, slide, and screen stays on brand.
What Design.md actually is
Design.md is an open-source file format, similar in spirit to files like agents.md or skills.md that many AI builders already use. Think of it as a markdown file that holds the DNA of a design system: typography, color palette, spacing, animation rules, and sometimes WebGL effects.
You attach this file to your prompt, and your AI agent uses it to generate designs that share the same identity across every screen and format.
A simple way to think about it:
- HTML is the finished dish.
- Design.md is the recipe.
- Skills are the ingredients.
When you combine all three, you get designs that feel intentional, consistent, and polished — not random or generic.
The problem Design.md solves
Most builders run into a problem called design drift. You start with a beautiful first screen, but as you keep prompting, the design slowly falls apart. The footer looks different from the hero. The pricing page looks like a different startup. The mobile version barely resembles the desktop version.
Design.md fixes this by giving your AI a foundation it can return to every time it generates a new section, page, or format. You stop one-shotting and start systemizing.
Why design taste is the new moat
Five or ten years ago, a purple gradient and a clean sans-serif font could make your site look cutting edge. Today, that same look screams generic. The baseline of design has risen so high that “good enough” no longer stands out.
The real moat now is taste.
Taste means:
- Knowing when a design feels alive versus templated.
- Spotting the difference between care and copy-paste.
- Making fast, confident decisions about typography, color, spacing, and motion.
- Avoiding the cookie-cutter look that screams “I used a template.”
If your landing page looks like a thousand other startups, your perceived value can drop by 10x or even 100x in a user’s mind. Taste is what protects you from that.
How to use Design.md: the step-by-step workflow
Here’s the workflow designers and solo builders are using to create scroll-stopping designs with AI.
1. Start with reference
Every designer — even the best ones — starts by studying other work. Browse design communities, scroll through inspiration sites, and save designs that resonate with you. The goal isn’t to copy. It’s to build a personal library of taste you can pull from later.
2. Download a Design.md file
Find a Design.md file that matches the vibe you want. Many are free to download from open-source design system communities. The file contains:
- Color tokens
- Typography rules
- Spacing system
- Animation guidelines
- Sometimes WebGL or 3D effects (which power things like laser backgrounds and animated heroes)
3. Pair it with an HTML reference
Design.md gives your AI the recipe, but pairing it with an HTML file gives it a finished example to study. This combination dramatically improves output quality — the markdown holds the foundation, and the HTML shows what “done” looks like.
4. Add both files to your prompt
Attach both the Design.md and the HTML reference to your prompt in your tool of choice. Then describe what you want:
Create a landing page for my startup called Aura. It’s a chat app powered by AI that ships content to people’s email.
Your AI now has the blueprint and the example, so the output stays on brand instead of drifting toward generic.
5. Layer in skills
Skills are reusable prompt fragments that handle specific design effects: lasers, skeuomorphic buttons, 3D globes, custom shaders, copywriting improvements, and more. Apply a skill on top of your Design.md to add personality and stand out.
6. Iterate, then remix
There are two modes you’ll switch between:
- Iteration is for refining what already works. Small tweaks, polish, and improvements. Use this about 90% of the time.
- Remix is for branching into new directions. Use it about 10% of the time when you want a totally different look or want to spin off a new product category.
The builders making the best AI-generated designs aren’t one-shotting. They’re running hundreds — sometimes thousands — of iterations per product.
7. Expand to new mediums
Once your Design.md is locked in, you can use it to generate:
- Mobile app screens
- Slide decks
- Promo videos
- Motion design
- Social media graphics
- Email templates
Because the design DNA is portable, everything stays consistent across formats. You can move from Lovable to Cursor to Codex to Figma and the system follows you.
Tools that work well with Design.md
You don’t need any specific platform to use Design.md, but a few tools make the workflow smoother.
Other tools worth knowing:
- Codex and OpenCode for local agent workflows.
- Cursor for editing inside your IDE.
- v0, Lovable, and Bolt for browser-based generation.
- Google Stitch as a free alternative with an infinite canvas.
- Figma Community for traditional design starting points.
The key takeaway: Design.md is portable. Build in one tool, move to another, and your design system follows you.
Common mistakes to avoid
Watch out for these traps if you want your AI-generated designs to actually stand out:
- One-shotting and stopping there. A beautiful first screen isn’t a product. Plan for hundreds of iterations.
- Using purple gradients. They’re the new “AI-generated” red flag. Pick a unique palette.
- Copying full templates. This locks you into looking like everyone else. Start with a system, not a finished page.
- Stuffing everything into
agents.md. It burns more tokens and makes prompts too general. Use Design.md per project and skills per workflow. - Skipping human judgment. AI handles the pixels, but you still need to make the taste calls.
How the designer’s role is changing
A few years ago, designers spent their days nudging rectangles in Figma. Today, the job looks completely different. Designers — and anyone building products — are making more judgment calls per minute than ever before.
You’re not the one moving pixels anymore. You’re the one deciding:
- Whether a design has soul.
- Whether the spacing feels right.
- Whether the motion adds value or distracts.
- Whether the copy matches the brand.
The AI does the labor. You provide the taste.
This is also why so many solo founders now run holding companies of multiple products by themselves. With Design.md, skills, and AI agents, one person can manage four or five products at the same time, queuing up generations across projects.
Build a second brain for design
Most people have a second brain for notes, ideas, and meeting recaps. Very few have one for design inspiration.
If you’re serious about creating beautiful products, start capturing inspiration as you find it:
- Screenshot websites that stop your scroll.
- Save Design.md files you love.
- Bookmark animations, transitions, and interactions.
- Keep a folder of typography pairings that feel fresh.
- Follow makers and designers in your niche.
Refer back to this library every time you start a new project. Over time, your taste will compound — and your work will pull ahead of generic AI output.
Wrapping up
The big idea is simple: AI gives everyone the same tools, but taste and workflow are what set people apart. Design.md is one of the most powerful additions you can make to your stack right now because it gives your AI the blueprint it needs to produce work that actually looks good.
Pick one Design.md file this week. Pair it with an HTML reference. Build one landing page or slide deck end-to-end using the workflow above. That’s all it takes to see the difference.
If this was useful, the next post worth your time is the one on building a one-person stack of products — the operational side of running multiple AI-built businesses without burning out.