Build Speso mini apps in PHP, or TypeScript and export JSON definitions for the developer portal.

This toolkit provides:

• Fluent builders for defining mini apps.
• UI components (views) and workflow actions.
• Serialization to JSON for portal testing.

• PHP 8.1+ and Composer (for the PHP toolkit)
• Node.js 18+ and npm (for JS/TS toolkits)

• PHP toolkit and examples
• JavaScript toolkit and examples
• TypeScript toolkit, build output, and examples

cd php
composer install

php examples/donate.php

Output is written to the dist folder and the script prints the path.

cd ts
npm install

node examples/donate.js

If build artifacts are missing, the demo will run the build step automatically.

Each toolkit provides a MiniApp builder that lets you:

• set app metadata (id, version, name)
• add pages
• compile to JSON

Views are UI components such as text, inputs, buttons, images, scaffolds, stacks, nav bars, and more.

Actions are workflow steps for app logic: form handling, casting, HTTP calls, response parsing, conditional branching, and alerts.

Serialization is automatic. The builder produces the JSON schema used by the developer portal.

• PHP examples include brand, pay, donate, and shop
• TypeScript examples include donate

1. Run any example to generate a JSON file in the dist folder.
2. Go to https://developer.speso.co and sign in.
3. Navigate to Developer → Mini Apps / Import.
4. Upload the JSON file and run the app in the portal test environment.

Missing dist folder

If an output folder is missing, create it:

mkdir -p dist

TypeScript build artifacts missing

From the TypeScript folder:

npm install
npm run build

PRs and issues are welcome. Keep examples runnable and write JSON output into the dist folder.# Mini App Developer Toolkit