This chapter reflects the development build as of 2026-10-21. The current App API is 9, and the minimum supported is 3. The stable release and Beta may expose different APIs. Check the target client before installing, and state compatibility requirements when you publish.
Prerequisites
You need a computer with the gugu desktop app and a text editor. This example has no build step and does not need Node. Git, Node.js, and a GitHub account are only needed when you submit to the market. If you want an Agent in gugu to write it for you, first have it read theapps and apps-ui topics with guide_read. Then have it read the topics listed in the API overview for the features you need. You can also build the package in an external editor; a person then installs it in gugu.
Build a notes App
Create anotes-starter folder and add the three files below. The complete, copyable folder is in the starter sample in the docs repository. The sample keeps its Chinese interface strings: the tab title 便签 means “Notes”, and 保存 is “Save”. Replace them with your own wording.
manifest.json declares the name, version, and page. It requests no extra permissions.
main.html uses the page styles gugu provides. The script lives in a separate file.
main.js saves the draft and shows any read or write failure.
Install and check
- In gugu’s App management, choose to install from a folder and select
notes-starter. - Open the 便签 (Notes) tab, type “Organize the literature tomorrow”, click 保存 (Save), and confirm the save result appears.
- Close the App and reopen it. Confirm the same text is still there. The draft is stored on this device and does not sync across devices or group members.
- Switch between light and dark themes and narrow the page. Check that the label, text box, and button still work.
app_create, app_install, and app_check to build, install, and check an App. Declaring a permission does not grant it. For detailed steps, see Development and debugging.
Next steps from the sample
There is currently no separate official App template repository. This page gives a copyable folder, and real Apps are in
sources/ of the market index repository. When copying, keep the licenses required by the code and dependencies you use, and replace the identifiers with your own.