English | 中文
TopBase is the starter scaffold for apps that run on TopArrow. It contains no application code. It gives AI coding tools (any tool that reads AGENTS.md, such as Cursor, Claude Code, or Codex) the platform rules and a documentation layout, so the app they build runs on TopArrow and stays easy to maintain.
TopArrow runs apps locally on the user's own computer. It ships PHP, Node, Python, and Electron runtimes, and SQLite is the only database.
TopArrow runs on Windows 10 x64 and later, and on Macs with Apple silicon running macOS 11 or later.
- Website: https://www.toparrow.top/
- Download: https://www.toparrow.top/web/download.php
./
├── AGENTS.md Rules for AI coding tools: runtime, platform contract, docs, local git
├── manifest.json Tells TopArrow how to install and run the app
├── .gitignore
├── _doc/ Project notes the AI reads first and keeps up to date
│ ├── projectinfo/ App structure, modules, and stack
│ ├── changelog/ Running change log
│ ├── plan/ Plans for larger features
│ ├── testcase/ Test plans and cases
│ ├── references/ External API and third-party docs
│ ├── writing/ Design notes and other writing
│ └── aicode/ Platform rules (runtime.md, git.md, publish_check.md) and examples
├── _aiact/ Scratch space for temporary AI code, not committed
└── lang/docs/zh/ Chinese version of AGENTS.md, _doc, and _aiact
In TopArrow: creating a new app starts from this scaffold automatically.
From GitHub: click Use this template or clone the repository, then:
- Fill in
id,name,description, andruntime.typeinmanifest.json.idcannot change after the app is published. - Open the folder in your AI coding tool and describe the app you want. The tool reads
AGENTS.mdand follows it. - You can delete
README.md,README.zh-CN.md, andLICENSE. They describe this repository, not your app.
manifest.json ships in the PHP shape. For Node, Python, or Electron, see _doc/aicode/rules/runtime.md.
The files at the root are in English. lang/docs/zh/ holds the Chinese version. When TopArrow creates an app in a Chinese environment, it replaces AGENTS.md, _doc/, and _aiact/ with the Chinese copies and removes lang/docs/.
lang/docs/zh/manifest.json is not a full manifest. TopArrow only copies its name and description into the root manifest.json.
To do the same by hand, copy AGENTS.md, _doc/, and _aiact/ from lang/docs/zh/ over the ones at the root (replace _doc/ as a whole, since some folder names differ), take name and description from lang/docs/zh/manifest.json if you want them, then delete lang/docs/.
This repository is a mirror of TopArrow's internal repository. Issues and pull requests are welcome. Accepted changes are merged internally and appear here with the next sync.
README.md, README.zh-CN.md, and LICENSE exist only in this GitHub repository. They are left out of the scaffold package TopArrow distributes.
MIT-0. Apps built from TopBase do not need to keep this license or any copyright notice.