Quickstart
Go from an empty folder to an application running in the local emulator. Let a coding agent write it, or create it yourself.
You need Node.js 24 or newer. For the emulator, you also need Docker and mkcert.
-
Install Adaptkit.
Terminal window npm install --global @mochabug/adaptkit@latest -
Create a Git repository for your applications, and install the agent skills in it.
Terminal window mkdir adapt-apps && cd adapt-appsgit initadaptkit skill -
Create the application.
Start your coding agent in the repository, and describe the application:
Create an Adapt app in hello_world/. It has one vertex, "greeting".The vertex shows a page where a visitor types their name and clicks Send.Then it sends the name on its output and completes. In the vertex settings,users can change the page's heading.The agent proposes a structure first: the vertices, their signals, and their pages. Approve it, and the agent creates the project, writes the code, and builds it.
Terminal window adaptkit init --dir hello_world --name hello_world --vertex greeting \--capabilities browser --endpoints http --api http \--frontend react --ssg --no-interactiveThis creates a vertex with a page, in React. Leave out the options to choose them in a wizard. See
adaptkit init.To add a settings page, add
configuratorto--capabilities. Such a vertex runs only after its settings page saves valid settings, and the generated one does not save yet. See Configurators. -
Preview the pages.
Terminal window cd hello_worldnpm run devThe server prints its address and a path for each page:
➜ Local: http://localhost:3000/→ greeting/executor · /src/greeting/ui/executor.htmlOpen
http://localhost:3000/src/greeting/ui/executor.html. A mock API stands in for the backend. -
Run it in the emulator.
Terminal window adaptkit emulator setup # once: trusts the emulator's certificatesnpm run emulator # starts the emulator at http://localhost:51001npm run emulate # builds and uploads the applicationIn the emulator, select the greeting vertex. If it has a settings page, click Configure and save. Then click Run to use the page. See Test in the emulator.
-
Publish it.
Set
organizationinmanifest.jsonto your organization’s ID, and replace the placeholder texts. Then:Terminal window adaptkit version patchnpm run publishAdaptkit opens your browser to sign in, then uploads. See Publish and update.
Next steps
Section titled “Next steps”- Build with an AI agent: get the most out of your agent.
- Anatomy of an application: what each generated file does.