Skip to main content
An App is a folder holding a manifest, pages, and optional programs. It can add work pages to tasks, let a group edit files together, or give Agents tools and skills. Users choose which regular Apps to install. This chapter covers getting started, the API, debugging, submission, and maintenance. Start with a notes App that saves a draft, then add shared files or Agent tools as needed. For installation and permissions from the user’s side, see App.
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 the apps 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 a notes-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

  1. In gugu’s App management, choose to install from a folder and select notes-starter.
  2. Open the 便签 (Notes) tab, type “Organize the literature tomorrow”, click 保存 (Save), and confirm the save result appears.
  3. 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.
  4. Switch between light and dark themes and narrow the page. Check that the label, text box, and button still work.
A package that requests permissions shows a confirmation sheet, and the user decides whether to grant them. An Agent in gugu can use 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.