MyJackfruit

Help
Browse topics · Development

Development

← Development

How do I make my app easy for a first-time visitor?

Short answer

Tell Kai-Zen what a first-time visitor must manage to do, then watch someone new try it and tell Kai-Zen what was hard.

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

A first-time visitor is someone who opens your app with no one there to show them how. Your app is easy for them when they can do what they came for without help.

Make it a goal. In your plan, a Value is a goal for how well your app must do something, and it can say exactly this, for example: a new visitor can book a time without help. Tell Kai-Zen, the planning agent, in your own words what a first-time visitor must manage, and how fast; a number can come later. The answers Why does my plan need Values and goals? and Do I have to give numbers? I do not know them. tell more.

What your AI does already. Agent.Coder, the agent that writes your app's code, follows written rules that help a newcomer find their way. An agent is your AI following one written procedure, its standing instructions, for one kind of work.
The main menu, unless you describe another: a button at the top shows where you are, and a large panel shows the main sections. It lists only what is built, and what you name as coming, so no one is sent to an empty page.
Buttons are named by what they do, such as Save, never OK or Yes, and in a row of buttons that saves, confirms or closes something, the main button is always on the right.
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.
Every app must meet WCAG 2.1 AA, an international standard for making web pages usable by people with disabilities; the answer on checking that your app works with a screen reader or large text tells more.

Your words. Clear words on the screens help a newcomer most. Give Kai-Zen your own words where you have them; the answer Who writes the text in my app, and can I change it myself? tells more.

Watch someone new try it. Rules cannot tell you whether your app is easy; people can. Ask someone who has never seen your app to do one thing, such as booking a time, and watch without helping. Note where they stop or guess. Before it is live, they can try it on your computer; see How do I show my app to someone for their opinion before it is live? Once it is live, see How do I get feedback from the first people who try my app? GilbPlatform and GilbApp have no feedback form or survey of their own, so you ask the people yourself.

Then tell Kai-Zen what they found hard, in your own words; a change goes as the answer How do I change the product while a project runs? shows. After each step Kai-Zen shows you what was measured and the next step.

No standard promises that an app is easy to use; what first-time visitors manage to do tells you.

This answer is written for a computer screen.

Source: Standards: Rule_Code_default-menu (RuleDefmenuSectionMenu: A header button shows where you are. A large panel opens; RuleDefmenuDescribedWins; RuleDefmenuOnlyBuilt: lists only what is built, except an option the owner names as Coming); Rule_Code_design-guide (RuleUiActionRowMacOrder: "Its label is a verb that names the act (Save, Add bicycle, Give access), never OK or Yes."); Kai-Zen.ConstraintRules.Reuse; Rule_Code_accessibility (RuleA11yWcagAa); Kai-Zen.Update; Kai-Zen.Cycle (Next). Live help pages, sentences shared: Why does my plan need Values and goals?; Do I have to give numbers? I do not know them.; How do I get feedback from the first people who try my app? (no feedback form or survey of their own); How do I show my app to someone for their opinion before it is live?; Who writes the text in my app, and can I change it myself?; How can I see what I've built? (what was measured and the next step); How do I check that my app works for people who use a screen reader or large text?.

Checked against GilbApp d529620.