MyJackfruit

Help
Browse topics · Development

Development

← Development

I need help with the design. How do I make my app look professional?

Short answer

Tell Kai-Zen who your app is for and show apps you like; your AI follows written design rules, and you choose the style.

Before you start

Words used here (1)
Kai-Zen
Kai-Zen is the planning agent: it finds out what you want, chooses the way, hands the work to other agents and reports back.
Deeper

You get help: you do not have to be a designer. Kai-Zen, the planning agent, asks you what only you know, and Agent.Coder, the agent that writes your app's code, designs the screens as it builds them, by written design rules. An agent is your AI following one written procedure, its standing instructions, for one kind of work. No standard promises that your app will look professional, but you and your AI can do a lot to make it clear, tidy and the same all through.

What you do.
Say who your app is for and what they must get done. What the app must do and for whom comes first, and its screens are worked out from that.
Show apps or websites you like, and say what you like about each; the answer Can I show examples, drawings or screenshots of what I want? shows how.
Choose the style. When Kai-Zen sets up a new app, its first round of questions includes the app's look, its style. The default answer is that you choose the style yourself during planning, in the App Style Studio, a tool for choosing an app's look. The plan's standard calls the studio a developer tool, so you may need help to reach it: ask Kai-Zen in the chat, or write to [email protected]. In it you choose from ready-made sets of colours, 348 of them taken from Sanzo Wada's A Dictionary of Color Combinations, and from 48 fonts, with eight pairs of fonts that go well together; it keeps text readable against its background. On a published app, a font must be part of the app's own files or already on the visitor's device: the rules of a published app block fonts loaded from other websites. Until you choose, the app is built with a default style, so it has a look from the start. The answer Who decides how my app looks? tells more.

What your AI does.
The same look is used all through the app: a plan for software always holds the rule that the app reuses its own buttons and ways of doing things, never a second look for the same thing, with you as the person who requires it.
For an app's screens, Agent.Coder follows a written design guide: every layout is designed for the smallest screen first; one main colour is used for buttons, links and what is selected; cards, boxes and buttons look the same everywhere; and in every row of buttons that saves, confirms or closes something, the main button is on the right, named by what it does, such as Save, never OK or Yes, with Cancel just to its left.
Every app must also meet WCAG 2.1 AA, an international standard for making web pages usable by people with disabilities; the answer on checking your app for a screen reader or large text tells more.
For pages that present you or your business, such as a start page, an about page or a blog, a separate written rule on design taste applies instead.
Agent.Tester, the agent that tests what others built, fails a part whose colours, buttons or input fields break some of these rules, such as a row of buttons in the wrong order.
When a step changes a screen, Agent.Coder opens the changed screen in a real browser at phone size and takes a screenshot before it hands the step back; if it has no browser tool, it says so. Ask your AI to show you that picture.

Judge it and change it. You first see the screens when a step is built; Kai-Zen does not draw a picture of a screen before. Before it is live, Agent.Coder gives you an address to open in your browser on your computer. When the step is live, Kai-Zen asks you to check it live, the way a user would; send back what you want different, and it is fixed and put live again until you approve. Say in your own words what looks wrong to you, for example: The buttons on the start page are too small, and the grey text is hard to read.

More on looks:
- Will my app look good on phones as well as computers?
- Can my app have a dark mode?
- How do I change the look of one screen without changing the rest?
- How do I make my app easy for a first-time visitor?
- Can I see a few design ideas before I choose one?

Help from a person. A designer or a friend can help you: share the project's vault with them, the place on GilbPlatform where the project's records are kept, so they can read the plan and give their view; the answer Can a developer or a friend help me? shows how. The help pages and MyJackfruit's pages name no developers or advisers to hire.

GilbApp's own colours are another thing: they change only how GilbApp looks to you, not your app. The answer How do I switch between light and dark, or change colours? shows them.

This answer is written for a computer screen.

Source: Standards: Kai-Zen.New (Setup: the round asks for the app's style, default App Style Studio; Standard: style-runtime with a default style); App.Style.Choose (Open: a developer tool, not part of the app; Colours; Look; Logo; Save); Kai-Zen.ConstraintRules.Reuse; Agent.Coder (Contextual: Rule_Code_design-guide for app UI, Rule_Web_design-taste for marketing pages; AfterIncrement: screenshot at phone size); Rule_Code_design-guide (RuleDsgnScope, RuleDsgnPrinciples: mobile-first, one accent colour; RuleDsgnCards; RuleDsgnInputs; RuleUiActionRowMacOrder; RuleDsgnFailConditions); Rule_Web_design-taste (RuleWebtasteDesignAuthority); Rule_Code_accessibility (RuleA11yWcagAa); Kai-Zen.HumanCheck. GilbPlatformCode 352c629a (https://github.com/KaiGilb/GilbPlatformCode, read 13 November 2026): units/style-studio/README.md (348 palettes after Sanzo Wada, A Dictionary of Color Combinations; 48 open-licence fonts; eight pairings; contrast always enforced), units/style-runtime/src/schema.ts:20-23 (a font is system or bundled). GilbPlatform 0fc5a548 (https://id.gilb.com/version, read 13 November 2026): workers/publish-ingest/src/checks.ts:171 (font-src 'self' data:). Live help pages, sentences shared: Who decides how my app looks?; Can I see what my first version will look like before it is built?; Can I show examples, drawings or screenshots of what I want?; How do I check that my app works for people who use a screen reader or large text?; How can I see what I've built?; Can a developer or a friend help me?; How do I switch between light and dark, or change colours?.

Checked against GilbApp d529620.