Documentation
How Rifframe works
Build wireframe pages, or a whole site, by composing sections from a library extracted from the structure of 300+ modern websites. Optionally, let an LLM fill it with copy from a brief. Export clean HTML+Tailwind, plain text, JSON, or a PNG image.
1. Editor basics
Open the app and you start with a default Classic template: hero, features, testimonials, CTA, footer.
- Hover any section to reveal its toolbar (drag handle, move up/down, variant picker, AI refill, delete).
- Click any text (headings, paragraphs, button labels) to edit it inline. The change is saved on blur and persists across variant swaps.
- Drag the handle (or use the panel Structure) to reorder sections. Drop animations slide.
- Click the “+” between sections (visible on hover) to add a new section. Pick a type, then a variant.
2. Templates
Templates are pre-composed pages: a curated stack of sections in a sensible order for a given use case. Open one and tweak the copy, variants, or order. Faster than starting blank when your need fits an existing pattern.
Three ways to load a template
- From /dashboard, the “Try a template” panel.
- From the editor toolbar → Templates dropdown.
- Direct URL:
/app?template=AI+tool, useful for sharing a starting point.
| Template | Best for | Sections |
|---|---|---|
| Classic | Generic landing, simplest reference, good for learning | 6 |
| Modern SaaS | B2B SaaS with full funnel: logos, stats, pricing, FAQ | 10 |
| Editorial | Typography-driven blog or magazine, personal brand | 6 |
| Creator | Newsletter, course, or personal product | 6 |
| Waitlist | Pre-launch / coming soon, with email capture | 7 |
| Agency | Services, freelance, case studies + timeline | 8 |
| Mobile App | App store landing, screenshots + ratings | 7 |
| Open Source | Dev tool, GitHub stats + how it works | 7 |
| AI tool | AI product launch with badge + how-it-works + pricing | 10 |
| Portfolio | Personal site, case studies, freelancer | 6 |
| E-commerce | Online shop, featured product grid + ratings + faq | 9 |
| Local business | Services + FAQ + contact form for trust | 7 |
None fits exactly? Pick the closest, then add or remove sections. Templates are just starting points, nothing is locked in.
3. Sections, styles & variants
Every section has a type (30 of them: hero, logos, features, how-it-works, stats, results, testimonials, comparison, integrations, product-grid, faq, pricing, code, team, contact, gallery, video, press, blog-preview, careers, manifesto, cta, lead-magnet, nav, footer, announcement-bar and more), a style (split, centered, asymmetric, …) and a specific variant (default, with-trust, compact, …). Click the section label in the toolbar to jump straight to any variant via a dropdown, no need to cycle with arrows.
270+ variants total, all extracted from the structure of 300+ modern websites. Drop a section anywhere on the page via the+buttons that appear between rows on hover.
All sections share the same horizontal rhythm (max-w-7xl) and grayscale palette (no colors), so swapping styles never breaks visual harmony.
4. AI Generate
Click ✨ Generate in the bottom toolbar. You get three modes:
- Refill copy: fills every text slot of the current layout with content matching your brief. Structure stays the same.
- Full page: the AI also picks the section types and variants that best fit your brief. One pass, one full page.
- Full site: the AI plans the pages your site needs (3 to 5), builds each one, and shares a single nav and footer across all of them. One brief, a complete website in under a minute. Counts as one generation.
Pick a tone (Neutral, Premium, Casual, Punchy, Inspiring, Technical). Same brief in different tones gives radically different feels.
Per-section refill: the ✨ icon in any section's toolbar regenerates only that section using your last brief and tone. Useful when you add a new section after a global generation.
Behind the scenes: one pass through our AI provider. The brief language drives the output language: type your brief in French and the page comes back in French.
5. Responsive preview
Three icons in the toolbar: Desktop, Tablet (768 px), Mobile (375 px). Tablet and mobile render the page in an iframe with the actual viewport width, so Tailwind's responsive classes (sm:, lg:) apply correctly. It's a real preview, not a fake squeeze.
Tablet and mobile are read-only. Switch back to Desktop to edit. The exported HTML is responsive natively, no matter which viewport you used to author.
6. Export options
The Export button in the bottom-right opens a menu with four formats. PNG is on every plan; HTML, plain text, and JSON require Pro.
- PNG: a 2× retina screenshot of the desktop layout. Always full width even when you're zoomed out or in mobile preview. Free includes a small “Made with Rifframe” watermark; Pro is clean.
- HTML + Tailwind (standalone) Pro : a single HTML doc with Tailwind via CDN. Drop it into any folder, double-click, done. Great for handoff to a developer or to Claude Code for porting to Next.js / Astro / Vue.
- Plain text Pro : sections labelled, slot names with their copy. Drop in a CMS or share with a copywriter.
- JSON Pro : array of
{type, variant, content}. For devs who want to feed the structure into their own pipeline.
HTML, plain text and JSON are copied to your clipboard. PNG triggers a download.
7. Figma workflow
We don't export native Figma files. That would require a custom plugin and the result would be brittle. Instead, use this proven workflow:
- Build your project in Rifframe.
- Click Export → HTML + Tailwind. The full doc is in your clipboard.
- Open Figma and install the html.to.design plugin (free, well-maintained).
- Run the plugin and paste your HTML. It imports the page as native Figma frames with editable text, shapes, layout, not a flat image.
For a quick visual share or a Slack message, the PNG export is usually faster.
8. Keyboard shortcuts
| Cmd / Ctrl + Z | Undo last action (edit, swap, drag, generate, …) |
| Cmd / Ctrl + Shift + Z | Redo |
| Tab (on a drag handle) | Focus a section to reorder via keyboard |
| Esc (in Generate popover) | Close the popover |
| Enter (in brief field) | Trigger Generate |
Cmd+Z works while you're editing a slot too, but it undoes the text you typed locally (browser default), not the global page. Click outside the slot first to undo at the page level.
9. Design system
Every section is built from the same atomic UI elements so any combination stays visually coherent. Strict grayscale, no colours.
Typography · Geist
Aa
The quick brown fox jumps over the lazy dog 0123456789
Palette
white
50
100
200
500
700
900
Buttons
Badge
Avatar
Icon box
Image placeholder
4/3 (default)
square
10. Sections API & MCP
Every Rifframe section is also available outside the editor, as clean Tailwind HTML over a REST API and an MCP server. This is how coding agents (Claude Code, Cursor) pull sections straight into a codebase. Free during the beta, no API key required.
| Endpoint | What it does |
|---|---|
| GET /api/v1/sections?q=... | Search the catalog by intent (English queries) or filter by type. Empty query returns a curated featured set |
| GET /api/v1/sections/{type}/{style}/{name} | One section as HTML + typed slots (sample text and writing hint per slot). Add ?anchors=true to keep data-slot attributes for deterministic filling, ?format=document for a standalone preview page, ?surface=muted|dark for background rhythm |
| GET /api/v1/tokens | The CSS variable contract all sections consume. Paste it in your Tailwind entry, override with your brand colors |
| POST /api/mcp | MCP server (Streamable HTTP): search_sections, get_section, compare_sections, get_tokens |
Connect your agent
# Claude Code claude mcp add --transport http rifframe https://rifframe.app/api/mcp
Any MCP client works (Codex, Cursor, VS Code, Windsurf...): point it at https://rifframe.app/api/mcp. Per-client setup on the agents page.
Full reference with parameters, response schemas, and examples in the API reference. Setup guide and the reasoning behind the token contract on the Rifframe for AI agents page.