Skip to content
Home
Docs/Visual Designer

Visual Designer

The Visual Designer builds HTML and CSS screens on a native canvas. Drag components in, set layout and styles, edit per breakpoint, add states, interactions and animations, then export HTML, CSS or SVG, or React, Vue and Svelte with Pro. It can also design a screen from a written brief with your own AI provider key. This page walks through every screen of the module, what you can do there, and what you can't, with the reason.

What it is and how to open it

The Designer is a full-screen module, not one of the five pages of the pager. It opens on a start screen, and a design opens in the editor. Everything is saved on your device.

Ways in

FromHow
ToolsBottom bar or rail → Tools → Designer.
Command paletteRun the command Designer (Build interfaces visually).
HomeThe quick action Designer. The Recent designs widget opens the Designer too, on its start screen rather than on the design you tapped.
AI ChatIn the artifact viewer of a reply, ⋮ More actions → Open in Designer. It is offered for HTML and SVG artifacts and warns Layout may change, because the importer keeps only a subset of HTML.
Toolbox onlyThe Home quick action Media opens the Toolbox on its own, without the rest of the Designer.
The Designer does not open .html files from the editor or the file explorer. To bring existing HTML in, use Import from HTML in My Designs, or send an HTML artifact from AI Chat.

Where your designs live

  • Each design is a .pcd file in the app's private storage. Every save keeps the previous copy next to it as a .pcd.bak.
  • A design autosaves about 3 seconds after your last change and once more when you close it. Save in the top bar saves right away.
  • Named versions and automatic checkpoints are kept per design (see Versions and Compare in the editor).
  • Your preferences are kept per account: the floating selection bar on or off, the height of each panel, the order of the phone's bottom bar, left-handed mode, which first-time tips you have seen, and your recent and favorite components.

You can't, and why

  • Open a .html file from the editor or the file explorer directly in the Designer. The only ways to bring HTML in are Import from HTML and Open in Designer from an AI Chat artifact.By design

Screen map

One row per screen and sub-screen. The sections below describe each one.

ScreenHow you get thereWhat you can do
Start screenOpen the DesignerGo to My Designs, create a Manual Design, start an AI Design (Pro) or open the Toolbox.
My DesignsStart screen → My DesignsOpen, duplicate or delete designs; create one blank or from a template; import .pcd, Figma JSON or HTML; recover a damaged design.
Manual DesignStart screen → Manual DesignName a blank design and choose its size, orientation and layout mode.
Create with AIStart screen → AI Design (Pro), or ✨ Improve with AI in the editorWrite a brief, choose page type, style and design system, and generate.
Review AI ProposalOnly when a generated proposal has blocking validation findingsRead the Self-critique and the list of changes, then Apply to Canvas or Discard.
Editor on a tabletOpen or create a designCanvas plus a docked panel with five icon tabs: Components, Properties, Layers, Theme and Tools.
Editor on a phoneOpen or create a designCanvas plus a bottom bar: Pages, Components, Style, Layers and Tools. Panels open as bottom sheets.
ComponentsPanel tab or bottom barAdd components and blocks, insert downloaded Marketplace components and your own reusable components.
Properties (Style on a phone)Select a componentEleven tabs of settings for the selected component, plus comments.
LayersPanel tab or bottom barSee the tree, search, rename, reorder, nest, hide, lock and repair layers.
ThemeTablet: Theme tab. Phone: Tools → Edit ThemeEdit the light and dark themes, tokens, text styles and effect styles.
ToolsTools tab or bottom barExport, copy, view options, preview widths, Health, History, Versions, Shortcuts and Gestures.
Responsive previewTools → View → pick a widthSee the canvas at 320 to 1440 px without changing the design; edit breakpoint overrides in the Responsive tab.
HistoryTools → HistorySee your edits, and go back or forward to any of them.
Versions and Compare versionsTools → VersionsSave, restore, delete and compare versions.
Design System HealthTools → Design System HealthSee nine kinds of issues and fix some with one tap.
RecoveryOpening a damaged design, or Recover on its row in My DesignsRestore the automatic backup or a saved version.
Preview🌐 in the top barFull-screen WebView at 375, 768, 1280 or Full width; capture and share a PNG.
Shortcuts and GesturesTools → Shortcuts or Gestures; Ctrl+/ on a physical keyboardRead the keyboard shortcuts and the touch gestures; replay the first-time introduction.
ToolboxStart screen → Toolbox, or the Home quick action MediaEleven small design utilities: colors, CSS builders, typography and converters.

Start screen and My Designs

Opening the Designer shows its start screen: the title Visual Designer, My Designs on top and, under it, three tiles to create.

My Designs

Opens the list of your designs (Open or manage projects).

Manual Design

Creates a blank design that you build by hand (Drag-and-drop builder with full control).

AI Design

Designs a screen from a brief with AI (Describe your design in plain English). On Free the tile carries a PRO badge and opens the Pro wall instead.

Toolbox

Opens the eleven design utilities.

Visual Designer start screen with My Designs on top and Manual Design, AI Design and Toolbox below
The Designer start screen on a tablet: My Designs, then Manual Design, AI Design and Toolbox.

My Designs

Each card shows the design's name, its size, its number of pages and its number of components.

You can

  • Tap a card to open the design in the editor.
  • Open the ⋮ menu of a card to Duplicate it (the copy keeps the name plus “(copy)”) or Delete it. Delete asks for confirmation and permanently removes the design, its backup and all its versions.
  • Tap New Design to create one: a blank design with a name and a size, or From Template.
  • Use the three import buttons in the header: Import design (.pcd), Import from Figma (JSON) and Import from HTML.
  • Create as many blank designs as you want. On Free, a PRO badge appears on Manual Design and New Design once you have three designs made from templates, but it refers to the template limit, never to blank designs.
  • If a design file can't be read, its row says This design is damaged; tap Recover (see Recovery in the editor).

You can't, and why

  • Rename a design. The name is set when you create it; the app has no rename action for a whole design (pages can be renamed).Not yet

Create a design

There are three ways to start a design: blank, from a template, or by importing a file. All of them end in the editor.

Blank design

Manual Design on the start screen opens the new-design form.

You can

  • Name the design and choose portrait or landscape.
  • Pick a size: Mobile (360×640), Tablet (768×1024), Desktop (1280×800) or Custom, from 64 to 8192 px per side.
  • Pick the layout: Page flow (the default: blocks stack in order and export real, responsive HTML) or Free canvas (components sit at absolute positions).
  • Switch between the two later with Page flow in the zoom menu of the canvas.
  • From My Designs, New Design opens a shorter dialog: a name and a size, or From Template.

You can't, and why

  • Get a Page flow design from a template or an import: designs created from templates and imported designs start in free canvas.By design

Templates

From Template (Choose a Template) offers five built-in templates. All of them are 360×640 and start in free canvas. Their names and descriptions are in English whatever the language of the app.

TemplatePagesWhat it is
Landing Page2: Hero, FeaturesModern landing page with hero section and feature cards. 2 pages.
Login Form1: LoginClean login screen with email/password fields and social options.
Dashboard2: Overview, SettingsAdmin dashboard with stats cards, activity feed, and settings page.
Portfolio3: About, Projects, ContactPersonal portfolio with about, projects, and contact pages.
E-Commerce2: Products, Product DetailOnline store with product grid and detail views.

You can

  • Create a design from any template and edit it like any other design.
  • On Free, keep up to three designs created from templates at a time. Deleting one frees a slot (see Free and Pro). A duplicate of a template design, or a .pcd of one that you import again, counts too.

You can't, and why

  • Pick a Marketplace template here: the chooser lists only the five built-in ones. Marketplace project templates create a code project, not a design.By design
  • Create a fourth design from a template on Free: it opens the Pro wall for unlimited templates.Pro

Import

The three import buttons of My Designs open the Android file picker. Imported designs get a new id. Figma and HTML imports never count toward the template limit; a .pcd made from a template design keeps its template origin and does count.

ImportWhat it reads
Import design (.pcd)A .pcd file made by the Designer, for example one you saved on another device. A file over 20 MB is refused.
Import from Figma (JSON)A JSON file: the response of Figma's REST API or an export you saved by hand. It never connects to a Figma account. Limits: 10 MB, 5,000 nodes and a depth of 50.
Import from HTMLAn HTML file. Only div, section, h1 to h6, p, a, button, img and input become components; other tags are walked through; <script> is dropped. Styles come from inline style attributes and simple <style> selectors (tag, class, id). Limits: 10 MB and 5,000 nodes.

You can

  • Import a .pcd, a Figma JSON or an HTML file; the app says Design imported, Design imported from Figma or Design imported from HTML.
  • Open an HTML or SVG artifact from AI Chat with Open in Designer.

You can't, and why

  • Import from a Figma account or link: only a JSON file works.By design
  • Keep everything from an HTML file: scripts, @media rules, pseudo-classes, compound selectors and complex layouts are not carried over.By design
  • Import a .pcd larger than 20 MB: the app refuses it with “That file isn't a valid PocketCode design”.Device

The editor

A design opens in the editor: the canvas and the panels you use to build on it. The layout adapts to the screen, and each panel below has its own limits.

Layout and top bar

On a tablet or in landscape the editor docks a panel next to the canvas with five icon tabs: Components, Properties, Layers, Theme and Tools. On a phone it shows a bottom bar instead: Pages, Components, Style, Layers and Tools. The panels open as bottom sheets you can swipe between, and you can reorder them by long-pressing and dragging.

You can

  • Undo and redo from the top bar, up to 200 steps.
  • Tap ✨ Improve with AI to improve the open design (see Design with AI).
  • Tap Save to save now and 🌐 Preview to preview the design.
  • Manage pages from the page selector: switch page, Add page, Rename, Duplicate page and Delete (with confirmation). There is no limit on pages, but the last page can't be deleted.
  • Turn on the Prototype chip to draw arrows between components that have interactions. On a tablet there is also Compare, which shows two canvases side by side.
  • Collapse the docked panel with the tab at its edge, and in Tools turn the floating selection bar off or on or enable left-handed mode, which moves the bar. Panel heights are remembered per panel.

You can't, and why

  • Use Compare on a phone: the chip exists only in the wide layout (tablet or landscape).Device
  • Keep the undo history between sessions: it is emptied when you close a design and holds at most 200 steps.By design
Designer editor on a phone with the canvas, the three tools, the zoom pill, the Prototype chip and the bottom bar Pages, Components, Style, Layers and Tools
The editor on a phone: the canvas with the three tools, the zoom pill, the Prototype chip and the bottom bar Pages, Components, Style, Layers and Tools.

Canvas

The canvas is native, not a WebView. The artboard has the size you chose and its background is the theme's background color. Three tools sit at the bottom left, and a pill at the bottom right shows the zoom and the number of components, for example 100% · 28 comp.

You can

  • Switch between Select tool, Pan tool and Area select tool. Double-tap the Area tool to keep it active.
  • Open the zoom pill for Zoom in, Zoom out, an exact percentage (10 to 400), 50%, 100% and 200%, Fit to screen, Zoom to selection, 100% on selection, Minimap (off by default), Show Rulers, Page flow and Reset view.
  • Pinch with two fingers to zoom from 0.1× to 4×, anchored under your fingers, and drag with two fingers to pan.
  • Tap to select the innermost component, tap it again to go up one level, tap empty space to deselect, and long-press an unselected component to add it to the selection.
  • Drag a selected component to move it. Drop it on a container to nest it; an insertion line shows where it will land. Dragging an unselected component or empty space pans the canvas.
  • Resize with the four corner and four edge handles (a live preview shows width × height) and rotate with the circular handle, which snaps every 15°.
  • Double-tap text to open Edit text. Double-tap a container to isolate it; a breadcrumb with a close button (Exit isolation) lets you leave.
  • Snap to the 16 px grid and to the edges and centers of neighboring components, with distance labels, and drag guides out of the rulers.
  • Use the floating bar over the selection: duplicate, delete, Edit text or Lock aspect ratio, Change color, Center in parent, bring forward, send backward and More, which opens Properties.
  • Long-press a selected component for its context menu: Duplicate, Copy selection, Paste, Bring to front, Send to back, Lock or Unlock, Hide or Show, Remove from container, Convert to component, Export as HTML (that component as a file) and Delete.
  • With two or more components selected, an alignment bar offers Align left, Align center horizontally, Align right, Align top, Align center vertically, Align bottom, Distribute horizontally, Distribute vertically, Group and Ungroup.

You can't, and why

  • Change the grid size. The grid is a fixed 16 px: you can only show or hide it and turn Snap on or off.By design
  • Select the children of a container with the Area select tool: it selects only the top-level components that the rectangle touches.By design
  • Move, resize or rotate a locked component.By design
  • Type on the canvas itself: double-tap opens the Edit text dialog.By design

Spacing handles and layout guides

When a container with auto-layout is selected, handles over it let you drag its padding and its gap directly on the canvas.

You can

  • Drag a padding or gap handle to change the container's spacing; values round to whole pixels.
  • Turn on Show layout guides (Tools → View) to draw the padding bands and a label with the name and gap of every container. With it off, the guides show only on the selected container.
  • Drag guides out of the rulers (Show Rulers). Guides are saved with the design and components snap to them.

You can't, and why

  • Snap spacing to the theme's spacing scale: the handles round to whole pixels and do not snap to tokens. Design System Health can flag values that are off the scale and offer a replacement.By design

Components palette

The Components tab has four sub-tabs: Components, Blocks, Downloaded and My components. The palette holds 49 components in eight sections. Component names are English-only inside the app.

SectionComponents
Basics (6)Button, Link, Icon, Icon Button, Divider, Avatar
Text (6)Text, Heading, Quote, Code, Code Embed, Keyboard
Forms (8)Text Field, Text Area, Checkbox, Switch, Slider, Radio, Dropdown, Form
Containers (14)Row, Column, Card, Box, Spacer, Grid, Section, Header, Footer, Main, Scroll View, List, Accordion, Link List
Navigation (4)Navbar, Bottom Nav, Tab Bar, Breadcrumb
Media (3)Image, Video, Carousel
Feedback (7)Dialog, Snackbar, Progress Bar, Spinner, Badge, Chip, Rating
Data (1)Table

You can

  • Tap a card to add a component, or long-press a card and drag to place it exactly; dropping on a container nests it.
  • Find components with Search components…, filter by section, reuse Recent (the last 8) and mark Favorites with the star.
  • In Blocks, insert one of five ready-made blocks: Hero, Feature strip, Pricing card, Contact form and Footer.
  • In Downloaded, insert components you downloaded from the Marketplace. Apply as kit (tokens, styles, symbols) copies a downloaded design's tokens, styles and reusable components into yours.
  • In My components, insert your own reusable components.
  • Pick an icon for Icon and Icon Button from one set of 176 Material icons; icons export as vectors.
  • Add custom HTML, CSS and JS with Code Embed (Custom HTML / CSS / JS). It is emitted as-is in the export, without escaping, so don't paste code you don't trust.

You can't, and why

  • See a live thumbnail of each component: cards show an icon and the component's English name, and search matches those English names in every language.By design
  • Insert Marketplace templates here: Downloaded lists only downloaded components.By design
Designer editor on a tablet with the Components tab open: sub-tabs, search, Recent, section filters and component cards next to a landing page on the canvas
The editor on a tablet with the Components tab open: the sub-tabs, search, Recent, section filters and component cards. The tool buttons and the zoom pill sit over the canvas, and the five tabs of the docked panel are at the top right.

Properties

Select a component and open Properties (Style in the phone's bottom bar). The header shows the component's name with rename and delete buttons, Convert to component and Comments. Search a property… jumps to the tab that holds a property. There are 11 tabs (10 for components that aren't containers).

TabWhat it sets
DesignParent, position and size (X, Y, W, H) with Fixed, Hug or Fill and min/max, aspect ratio lock, resize from the center, constraints and rotation.
ContentThe options of that type of component: its text, image, icon, link, input options and so on.
StyleBackground (color, image or gradient), padding, margin, border and radius, stacked shadows, Effect styles, Copy style and Paste style. A dot beside a field shows whether its value is unset, set on the component or linked to a token.
TextTypography, with font families from a catalog of 50 web fonts.
LayoutContainers only: flex direction, gap, wrap and alignment, or a grid with tracks such as 1fr, 200px and auto and spans; a child can leave the flow and be positioned freely.
FXTransition, effects, filters, transform and custom CSS.
Responsive, States, Interactions, AnimationEach has its own section below.
CodeThe HTML and CSS this component would export, live (see Code inspector).

You can

  • Edit several selected components at once: a field shows the shared value or a mixed state and applies to all of them. The Design tab is disabled and says Select a single component to edit this.
  • Add Comments pinned to a component, resolve them and delete them. Comments travel with the design and are written to comments.txt in a ZIP export.
  • Convert the component to a reusable one, update all its instances or detach one (see Reusable components).

You can't, and why

  • See web fonts on the canvas: the exported HTML links the font from Google Fonts, but the canvas draws the closest system font.By design
  • Jump from the property search to the exact field: it opens the right tab, not the control.By design
Designer Properties tab with nothing selected, asking to select a component
The Properties tab with nothing selected: it asks you to select a component.
Style tab of a selected button with Effect styles, Copy style, a background linked to var(--color-primary), padding, margin and border
The Style tab of a selected button: Effect styles, Copy style and Paste style, a background linked to a token, padding, margin and border. The floating bar and the pink layout guides are over the canvas.

Layers

Layers shows the real tree of the page. Each row has its name, its z order (z: 3) and, for containers, its number of children ([4]).

You can

  • Search layers by name or by type with Search layers.
  • Rename a layer by double-tapping it, move it up or down with the arrows, nest it with Move into, take it out with Remove from container, hide it with the eye and lock it with the padlock. The ⋮ menu has Rename, Duplicate and Delete.
  • Turn on Selection mode to act on several layers at once: hide or show, lock, duplicate or delete, copy and paste.
  • Find components without a valid parent: the panel says how many there are and Repair moves them back to the root.

You can't, and why

—

Layers tab listing Footer, Pricing, Features and Hero with their z order, child count, move, hide, lock and menu buttons
The Layers tab: each layer with its z order and child count, a search box, and move, hide, lock and ⋮ buttons.

Theme, tokens and styles

Theme (a tab on tablets, Tools → Edit Theme on phones) holds the CSS variables of the design: Edit CSS variables for exported code.

You can

  • Edit the Light theme and, after Create dark theme, the Dark theme. Remove dark theme deletes it.
  • Under Exported page default choose whether the exported page follows the System, is Light or is Dark.
  • Create Tokens of eight types: color, spacing, typography, shadow, border radius, opacity, font size and line height. Each token shows how many times it is used, and renaming a token rewrites every reference to it.
  • Save Text styles and Effect styles and apply them with one tap.
  • See Kits if you applied a Marketplace design kit.

You can't, and why

  • Undo token changes: creating, renaming or deleting tokens, text styles and effect styles is not part of the undo history. Applying a style to components is.By design
  • Set the canvas background separately: the artboard color is the theme's background color.By design

Reusable components

Any selection can become a reusable component, like a symbol.

You can

  • Select components and choose Convert to component (or Ctrl+Alt+K). It appears in My components.
  • Insert it from My components; each use is an instance (Instance of …).
  • Edit the original and choose Update all instances to push the change to the other instances. Fields you changed by hand on an instance are kept.
  • Choose Detach to turn an instance back into regular components.

You can't, and why

  • Have instances follow the original automatically: instances are static copies, and nothing changes until you choose Update all instances.​By design

States

The States tab styles how a component looks when it is hovered, pressed, focused or disabled.

You can

  • Pick Hover, Active, Focus or Disabled and change styles for that state. They export as :hover, :active, :focus and :disabled rules.
  • Use View as to see the selected component in a state on the canvas; the preview applies to that component only. Reset the overrides of a state when you are done.

You can't, and why

—

Responsive

Responsive has two parts: previewing widths, and editing overrides for a breakpoint.

You can

  • Preview the canvas at seven widths from Tools → View: Original Size, Mobile S (320), Mobile (375), Mobile L (428), Tablet (768), Desktop (1280) and Desktop L (1440). A green banner (for example Responsive: Mobile S (320px)) says where you are, with Exit. The document does not change.
  • Open the Responsive tab to edit overrides for a breakpoint. The defaults are Tablet (up to 900 px) and Mobile (up to 480 px); you can add, edit and remove breakpoints between 100 and 2000 px, and Desktop is the base.
  • Per breakpoint and component, change position, size, visibility (Hide on this breakpoint), styles including layout, grid columns, and, for root components in free canvas, a stacking mode: Stack, Flow, Keep or Hide. Overrides export as real @media rules.
  • In free canvas, root components are reflowed automatically at narrow widths (grouped into rows, wrapped or stacked), in the canvas and in the export; your overrides win over that. In Page flow the browser does the reflow.

You can't, and why

  • Preview Mobile S, Mobile L and Desktop L on Free: those three previews need Pro (they share the gate of the React, Vue and Svelte export). Original, Mobile, Tablet and Desktop are free, and so is editing breakpoints.Pro
Tools tab on View with a green banner Responsive: Mobile S (320px) and the list Hide Grid, Snap ON, Show Rulers, selection bar, left-handed mode and the seven preview widths
Tools, View: the green banner says Mobile S (320px) is being previewed, with Exit; the list shows Hide Grid, Snap, Show Rulers, the selection bar, left-handed mode and the seven preview widths.

Interactions and prototype

The Interactions tab says what a component does when it is triggered. Interactions become real behavior in the exported HTML.

You can

  • Tap Add interaction and choose a Trigger: Tap, Hover, Scroll into view, Page load, After a delay (with Delay (ms)) or Form submit.
  • Choose an Action: Navigate to page, Open overlay, Close overlay, Toggle visibility, Scroll to, Set state or Open URL. For page changes pick a Transition: None (instant), Fade or Slide.
  • Turn on the Prototype chip to draw blue arrows from each component that has an interaction to its target component.
  • Run the prototype in Preview or in the exported HTML opened in a browser: pages navigate, dialogs open and close, and Form submit uses the browser's own form validation.

You can't, and why

  • See prototype arrows to pages: arrows are drawn only toward target components, not toward pages.By design
  • Share a prototype with a link: the Designer produces files (HTML, ZIP) and a PNG capture, and has no hosting.By design

Animation

The Animation tab adds one keyframe animation to a component.

You can

  • Choose a preset (fade in, fade out, slide in from the left, right, top or bottom, bounce, pulse or shake) or Custom, and edit its stops with Add stop.
  • Set Duration (ms), Delay (ms), Easing, Repeats (0 = loop), Direction and After finishing, and choose when it Starts: On page load or When it appears on screen.
  • Press Play to preview it on the canvas. It exports as a real @keyframes rule.

You can't, and why

  • Give one component more than one animation: there is at most one.By design

History

Tools → History lists your edits in chronological order, with the current one marked Here.

You can

  • Tap an entry to undo or redo up to that point.
  • Go back up to 200 steps.

You can't, and why

  • Read history entries in your language: they are written in Spanish whatever the language of the app is, for example “Mover Botón 2”.By design

Versions and Compare

Tools → Versions keeps full copies of a design that you can come back to.

You can

  • Tap Save version and name it. Named versions are never purged.
  • Restore a version: the current state is saved as an automatic checkpoint first, so you can come back. Delete version removes one.
  • Compare versions: pick two versions to see which components were Added, Removed, Moved or had their Style changed, plus New comments and Resolved comments, with a Side-by-side preview of both.
  • Automatic checkpoints (badge Automatic) are made every 10 minutes while a design is open, before an AI proposal is applied and before a restore. The 10 most recent automatic ones are kept.

You can't, and why

  • Read the names of automatic checkpoints in your language: they are fixed Spanish names such as “Automático”, “Antes de aplicar IA” and “Antes de restaurar”.By design

Design System Health

Tools → Design System Health audits the whole design. It never blocks anything: it only warns.

You can

  • See nine kinds of issues: colors off the palette, spacing off the scale, typography without a text style, low contrast (below WCAG AA, 4.5:1), skipped heading levels, images missing alt text, fonts the export would not link, components outside the artboard and text overflowing on mobile.
  • Tap Go to component on a row and, for colors and spacing, Replace with … to fix it.
  • The same check runs before an export and shows Export with open issues? (see Export and share).

You can't, and why

  • Read the issue messages in your language: they are written in Spanish whatever the language of the app is.By design

Code inspector and View Code

Two ways to read the code of a design without exporting it.

You can

  • Open the Code tab of a selected component to see the HTML and CSS it would export, live. Tap a property to copy that line, or Copy all.
  • Under Tools → Copy, use Copy HTML and Copy CSS for the whole design, and View Code to open the HTML / CSS dialog.
  • Edit the HTML in View Code to override what you preview or export once.

You can't, and why

  • Keep hand-edited HTML: it is cleared at your next canvas or theme change, so treat it as a one-off override.By design

Recovery

If a design file can't be read, the editor offers to recover it. It starts when you open the design or from Recover on the damaged row in My Designs.

You can

  • Choose Automatic backup, the .bak copy kept from your previous save, or Or a saved version: any version or checkpoint, not only the latest.

You can't, and why

—

Preview

The 🌐 button of the top bar opens a full-screen WebView of the design, with a tab per page when there is more than one.

You can

  • Choose 375, 768, 1280 or Full width, and Portrait or Landscape for 375 and 768.
  • Tap Capture and share to capture the preview as a PNG, in a device frame at 375 and 768, and open the share sheet.

You can't, and why

  • Browse to other sites or open local files from the preview: it does not navigate, and file:// and content:// are blocked.Google Play
  • Run external scripts, call fetch or WebSockets, use iframes or submit forms in the preview. Inline scripts, images, video and Google Fonts over https do load.Google Play
Full-screen Preview with the 375, 768, 1280 and Full width chips and the share and close buttons
Preview: a full-screen WebView with the 375, 768, 1280 and Full chips, and the share and close buttons.

Design with AI

The Designer can generate a design from a written brief with your own AI provider: you bring the key (see AI providers) and PocketCode does not supply a model. There are two entries. AI Design on the start screen (Pro) creates a new design, and ✨ Improve with AI in the editor works on the design you have open. Both use the same screen, Create with AI.

Generate a design

  1. 1On the start screen tap AI Design. The screen is titled Create with AI.
  2. 2Write the brief at the bottom, or tap one of the suggestions.
  3. 3Choose a Page type, a Visual style and a Design system, and tune the controls if you want.
  4. 4Check the provider and model chip at the top right. It starts on your preferred provider and the best design model it offers. Tap it to open the provider list, where a provider with no key shows Not configured.
  5. 5Tap Generate Design (Improve Design when improving). A progress card follows the steps and Cancel stops it.
  6. 6If you have not accepted that provider yet (here or in AI Chat), a dialog asks Send to …?. Tap Send and the generation restarts.

What you can choose

OptionWhat it does
Page type20 types: Landing Page, Dashboard, Blog, E-commerce, Portfolio, Admin Panel, SaaS App, Marketing, Form, Auth Screen, Onboarding, Settings, Pricing, Data Viz, Docs, Social Feed, Gallery, Email, Wireframe and Presentation, or a custom one you type.
Visual style10 styles: Minimal, Bold, Dark, Editorial, Playful, Corporate, Technical, Glassmorphism, Brutalist and Soft & Warm, or a custom one with three color pickers (Primary, Secondary and Background).
Design systemOpens the Design system sheet: Quick style, 14 built-in systems under Built-in systems (PocketCode, Material 3 Dark, Tech Utility, Warm Editorial, Material 3 Light, iOS / Apple HIG, Fluent Design, Glassmorphism, Ant Design, Nordic, Cyberpunk, Notion, Tailwind SaaS and Retro Terminal), My systems that you create, edit and delete, and Import DESIGN.md, where you paste a spec of at least 40 characters.
ControlsTypography (Sans, Serif, Mono, Display), Motion (None, Subtle, Expressive), Shape (Sharp, Rounded, Pill), density and an Accent color from seven presets or your own.
CustomizeOpens Refine your brief: who it is for, level of finish, brand style, tone and personality, content density, target device (mobile, desktop, responsive or tablet), requirements and constraints, and how you will know it is done.
AttachmentsUp to 8 items: Files from device, App project (canvas) or AI design. See the limits below: only their names reach the brief.
Provider and modelThe chip at the top right. You can also change the default model for this task in Settings, under Design generation.

What happens when you generate

The generation runs on your provider, in this order:

  1. 1PocketCode builds the prompt from your brief, the page type, the style, the design system and, if the design is not empty, a compact list of its components (up to 80).
  2. 2One call to your provider returns the proposal: a list of design actions (new components and, when improving, edits to existing ones).
  3. 3The model scores its own work on five dimensions: philosophy, hierarchy, execution, specificity and restraint. Unless it already flagged a weak score, a second call with a fresh context scores it independently, and the worse score counts.
  4. 4If a score is low, one refinement pass runs. Its result is kept only if it scores at least as well.
  5. 5The proposal is validated: at most 120 actions, 600 components after applying and 24,000 characters of custom CSS.

When it finishes

  • If the proposal passes validation it is applied for you, with no review step. AI Design creates a new 1440×900 design in free canvas, named after the first 50 characters of your brief. Improve with AI applies it to the open design after an automatic checkpoint (Antes de aplicar IA), and the whole proposal is a single undo step.
  • If validation finds blocking problems, Review AI Proposal opens instead: the Self-critique (an average out of 10 and five bars: Philosophy, Hierarchy, Execution, Specificity and Restraint), the Validation issues, and the list of changes as text. Apply to Canvas applies the valid part and tells you how many invalid actions were skipped; Discard drops it, after a confirmation.
  • To go back after an AI change, undo once or restore the automatic checkpoint from Versions.

Improve with AI

The ✨ button of the editor's top bar opens the creator on the design you have open. The main button reads Improve Design.

You can

  • Describe what to change. The generator receives a compact list of the design's components (id, type, name, position, size and parent) and can add components or edit existing ones: remove, restyle, move, resize or rename.
  • Use it on Free: the button has no plan gate of its own, and it needs your own provider key.

You can't, and why

—

Build with AI Office

Tools → Build with AI Office hands the open design to the AI Office so a team of agents can turn it into a real project.

You can

  • Open the AI Office with its lobby pre-filled: the design's name as the brief, and the design's HTML, CSS and JS and its theme variables as context.

You can't, and why

  • Use it on Free: the AI Office is Pro, so you see the paywall instead.Pro

You can't, and why

  • Use AI Design from the start screen on Free: the tile opens a Pro wall. Its title shows in Spanish (Diseñador con IA) whatever the language of the app.Pro
  • Generate without internet, without a provider that has a key, or before accepting the consent dialog for that provider.Needs network
  • Review a proposal visually before it lands: there is no visual diff, and without blocking findings there is no review screen at all. The review screen lists changes as text.By design
  • Get several proposals: How many proposals? (1, 2 or 3) only adds a line to the prompt, and one proposal is generated.Not yet
  • Steer the result with B2B professionals, Students / learners, Lo-fi sketch or Production-ready: those four options of Refine your brief do not change the prompt.Not yet
  • Make the AI read attached files, projects or designs: only their names are added to the brief.Not yet
  • Go past the validation limits: 120 actions, 600 components after applying and 24,000 characters of custom CSS.By design

Export and share

Everything is under Tools → Export and Copy. Each export opens a dialog with the file name and two buttons: Save, which writes the file with the Android file picker, and Share, which opens the share sheet.

Formats

FormatHow and what you getPlan
HTMLExport HTML (design.html).Free
CSSExport CSS (styles.css).Free
SVGExport SVG (design.svg).Free
ZIPExport ZIP (with assets): index.html, styles.css and script.js when the design has them, an assets/ folder with local images, and comments.txt when there are comments.Free
.pcdShare design (.pcd): the Designer's own file, which you can import again.Free
ReactExport React (Component.jsx).Pro
VueExport Vue (Component.vue).Pro
SvelteExport Svelte (Component.svelte).Pro
One componentContext menu → Export as HTML: that component and its children as an HTML file.Free
ClipboardCopy → Copy HTML or Copy CSS, for the whole design.Free
Code projectPocketCode Project: creates a real code project in your projects from the open design.Pro

Checks before exporting

  • Before exporting HTML, CSS, React, Vue, Svelte, ZIP or PocketCode Project, the Designer runs the Health check. If it finds issues it asks Export with open issues? with Export anyway or Review issues. Nothing breaks if you export as it is.
  • If the design is in free canvas it also asks Export in free-canvas mode?: Convert to flow first or Export as-is.
  • SVG and .pcd skip both checks.

Save or share

  • Save works for every format.
  • Share sends the text formats (HTML, CSS, SVG, React, Vue, Svelte and a component's HTML) as plain text: the code itself, not a file.
  • A ZIP or a .pcd is shared as a file: Share writes it to the app's cache and opens the Android share sheet with the file attached. Save also works for every format.

What the exported code contains

  • Semantic HTML with real @media rules for your breakpoints, :hover, :active, :focus and :disabled rules for states, @keyframes for animations, and a small script for page navigation, dialogs, form validation and on-scroll triggers.
  • The variables of your light and dark themes. The exported page follows the Exported page default you chose: System, Light or Dark.
  • A link to Google Fonts for each web font you used, so the page needs network to show them.

You can

  • Export the whole design as HTML, CSS, SVG, a ZIP or a .pcd on Free, and as React, Vue or Svelte with Pro.
  • Share a ZIP or a .pcd as a file with Share (the text formats go as plain text).
  • Export one component, copy HTML or CSS, or save the design as a code project (Pro).

You can't, and why

  • Share HTML, CSS, SVG or code as a typed file: the text formats are sent as plain text, never as text/html or image/svg+xml.By design
  • Export React, Vue, Svelte or PocketCode Project on Free: they open the Pro wall.Pro
  • See the web fonts of the exported HTML without a network: it links them from Google Fonts. The catalog has 50 families.Needs network

Toolbox

The Toolbox is a set of eleven small utilities for design work. Open it from the start screen (Toolbox) or from the Home quick action Media. It works on its own: you do not need an open design.

GroupToolWhat it does
ColorsColor PickerHEX · RGB · HSL converter.
ColorsGradient BuilderBuilds linear, radial and conic CSS gradients.
ColorsPalette GeneratorColor harmonies: complementary, analogous, triadic, split complementary and monochromatic.
ColorsContrast CheckerThe WCAG contrast ratio of two colors, for AA and AAA, normal and large text.
GeneratorsLorem IpsumPlaceholder text as words, sentences or paragraphs.
GeneratorsIcon SizesA reference of 28 icon sizes for Android, iOS, Web and macOS.
CSS ToolsBox ShadowA CSS shadow builder.
CSS ToolsBorder RadiusA CSS radius builder.
TypographyFont ExplorerPreview and compare 25 fonts.
TypographyType ScaleA modular scale from a base size, with eight ratios from Minor Second (1.067) to Golden Ratio (1.618).
ConvertersUnit ConverterConverts between px, dp, sp, rem, em and pt.

You can

  • Search the tools by name and open any of the eleven.
  • Use the Toolbox on Free: it has no plan gate.

You can't, and why

  • Edit images: the Toolbox does not crop, filter or export images, and it is not an image editor.By design

Gestures and shortcuts

Touch gestures are the main way to work. Keyboard shortcuts work with a physical keyboard. Both are listed in the app under Tools → Gestures and Shortcuts (Ctrl+/). A five-step introduction appears the first time you open the editor, and Replay introduction under Gestures shows it again.

Touch gestures

GestureWhat it does
TapSelect the innermost component. Tap it again to go up one level, and tap empty space to deselect.
Long-press an unselected componentAdd it to the selection.
Long-press a selected componentOpen its context menu.
Double-tap textOpen Edit text.
Double-tap a containerIsolate it.
Long-press a palette card, then dragPlace the component exactly where you drop it.
Drag a selected componentMove it. Drop it on a container to nest it.
Drag empty space or an unselected componentPan the canvas.
Drag with the Area toolSelect every top-level component the rectangle touches.
Two-finger drag or pinchPan and zoom, anchored under your fingers.
Drag from a rulerCreate a guide.
Drag a corner handleResize both axes.
Drag an edge handleResize one axis.
Drag the rotation handleRotate; it snaps every 15°.
Drag a padding or gap handleEdit the container's spacing.

Keyboard shortcuts

The shortcuts below are the ones the Designer handles. Ctrl is Cmd on a keyboard that has it.

KeysAction
↑ ↓ ← →Move the selection 1 px; with Shift, 10 px.
Ctrl+A · EscSelect all · Deselect.
Delete or BackspaceDelete the selection.
Ctrl+Z · Ctrl+Shift+Z or Ctrl+YUndo · Redo.
Ctrl+C · Ctrl+X · Ctrl+VCopy · Cut · Paste.
Ctrl+DDuplicate.
Ctrl+EEdit text.
Ctrl+G · Ctrl+Shift+GGroup · Ungroup.
Ctrl+] · Ctrl+[Bring forward · Send backward; add Shift to bring to front or send to back.
Ctrl+Shift+H · Ctrl+Shift+LHide or show · Lock or unlock.
Ctrl+Alt+KCreate a reusable component.
+ · -Zoom in · Zoom out.
0 · 1 · 2Fit to screen · 100% · Zoom to selection.
Ctrl+/Open the shortcuts dialog.

Accessibility and one-handed use

  • With TalkBack, custom actions move the selected component in steps of 8 dp and change its width or height.
  • Left-handed mode (Tools → Enable left-handed mode) moves the floating selection bar, and the bar can be turned off with Disable selection bar.
  • The height of each panel is remembered, so a panel opens the way you left it.

You can't, and why

  • Use the shortcuts with the on-screen keyboard: they need a physical keyboard. Right-click, the mouse wheel, Shift+click, Alt+drag, Space+drag and tool letters are not supported.Device
  • Remap them: the Designer's shortcuts are fixed and are not part of the app's keybinding settings.By design

Free and Pro

The Designer is almost entirely free. Pro opens a few specific things, and Free has one cap: three designs made from templates.

FeatureFreePro
Canvas, 49 components, 5 blocks, layout, tokens, themes, reusable components, states, interactions and animationIncludedIncluded
Pages, autosave, undo (200 steps), history, versions, recovery and HealthIncludedIncluded
Blank designs and Figma or HTML importsNo plan limitNo plan limit
Designs created from templates (their duplicates and re-imported .pcd copies count too)3 at a timeNo limit
Export HTML, CSS, SVG, ZIP and .pcd; Copy HTML and CSS; View CodeIncludedIncluded
Export React, Vue and SvelteNot availableIncluded
Responsive preview: Original, Mobile (375), Tablet (768) and Desktop (1280)IncludedIncluded
Responsive preview: Mobile S (320), Mobile L (428) and Desktop L (1440)Not availableIncluded
PocketCode Project (save the design as a code project)Not availableIncluded
AI Design (a new design from a brief)Not availableIncluded, with your own provider key
✨ Improve with AI (on the open design)No plan gate; needs your own provider keyIncluded, with your own provider key
Build with AI OfficeNot available (AI Office is Pro)Included
ToolboxIncludedIncluded
These rows follow UserPlan and PlanFeature in the app: maxDesignTemplates, UNLIMITED_TEMPLATES, EXPORT_FRAMEWORKS, AI_DESIGNER and AI_OFFICE. Prices and the full Free and Pro matrix are on the Plans page.

Privacy

  • The Designer itself does not upload your designs: they stay in the app's private storage until you export, share or send one to the AI Office.
  • AI generation sends your brief, the page type, style, controls and design system you chose and, when the design is not empty, a compact list of its components (id, type, name, position, size and parent) to the provider you picked. Attached items add only their names.
  • Until you accept a provider, the app asks Send to …? and explains that your message and what you attach go to a third-party AI provider over the internet. The choice is remembered per provider and per account. Avoid putting secrets or personal data in a brief.
  • The provider key is yours and is set up in Settings. See AI providers.
  • The exported HTML links Google Fonts for the web fonts you used, so whoever opens it fetches those fonts from Google. Images and videos load from their own https addresses.
  • The in-app preview runs your design in a locked-down WebView: no navigation to other sites, no local files, no external scripts, no network calls from scripts and no form submission.
  • When you export, the app announces the export (design id, name and format, never the content) on its internal event bus, and a Workflow can use it as a trigger.

Limitations

The limits that matter most, in one place. Each one is explained in the section where it applies.

  • Open a .html file from the editor or the file explorer directly in the Designer.By design
  • Rename a design after creating it.Not yet
  • Change the grid size: it is a fixed 16 px.By design
  • Keep undo between sessions: the history is emptied when you close a design and holds 200 steps.By design
  • Use Compare on a phone and the physical-keyboard shortcuts with the on-screen keyboard.Device
  • See component thumbnails in the palette, or search it by a name in your language: names are English.By design
  • See web fonts on the canvas: it draws the closest system font, and only the exported HTML links the font.By design
  • Have instances of a reusable component follow the original automatically.By design
  • Keep hand-edited HTML from View Code: it is cleared at your next canvas or theme change.By design
  • Share a prototype with a link.By design
  • Navigate, run external scripts, call the network or submit forms in the preview.Google Play
  • Preview Mobile S, Mobile L and Desktop L, export React, Vue and Svelte, save a PocketCode Project, use AI Design or Build with AI Office on Free.Pro
  • Make a fourth design from a template on Free.Pro
  • Generate with AI without internet, a provider key or the consent for that provider.Needs network
  • Get several AI proposals, or steer the AI with the four Refine your brief options that do nothing.Not yet
  • Import from a Figma account, or keep scripts and complex CSS from an HTML file.By design
  • Import a .pcd larger than 20 MB: the app refuses it.Device
  • Read history entries, Health messages and automatic checkpoint names in your language: they are fixed in Spanish.By design

Troubleshooting

This design is damaged

The file could not be read. Tap Recover on its row, or open it, and choose Automatic backup (the copy kept from your previous save) or Or a saved version.

Couldn't recover this design

Neither the automatic backup nor any saved version could be restored. If you exported a .pcd earlier, import it with Import design (.pcd).

That file isn't a valid PocketCode design

The file you chose with Import design (.pcd) is not a design made by the Designer, is damaged, or is larger than 20 MB. A Figma file goes in Import from Figma (JSON) (otherwise the app says “That file isn't valid Figma JSON”), and an HTML file in Import from HTML (“That file couldn't be read as HTML”).

Export with open issues?

The Health check found issues. Nothing breaks if you export as it is: tap Export anyway, or Review issues to open Design System Health.

Export in free-canvas mode?

A free-canvas design exports absolute positions. Convert to flow first stacks the blocks so the HTML is responsive; Export as-is keeps the positions.

Not configured

In the provider list that opens from the provider chip of Create with AI, a provider with no key carries this badge. Add a key in Settings (see AI providers), then pick the provider again.

The AI did not return any design actions.

The model answered without a usable list of design actions. Try again, make the brief more specific, or choose another model in the chip.

AI changes partially applied (N invalid actions skipped)

Part of the proposal broke a limit (120 actions, 600 components, 24,000 characters of custom CSS) or a rule such as pointing at a component that does not exist, so only the valid part was applied. One undo reverts all of it.

Send to …?

The app asks before sending your brief to a third-party provider you have not accepted yet. Tap Send to continue; the generation then starts again.

A font looks different in the exported HTML

The export links only the 50 families of the catalog from Google Fonts. Design System Health flags any other as Fonts that would not link on export, and the page needs network to load the ones it links.

A preview width asks me to go Pro

Mobile S (320), Mobile L (428) and Desktop L (1440) are Pro. Original, Mobile, Tablet and Desktop are free, and you can still edit any breakpoint.