Appaloft Examples

Official public examples for learning and smoke-testing Appaloft.

Canonical repository: https://github.com/appaloft/examples

Cloud monorepo mirror (private maintenance): appaloft-cloud/examples/.

Catalog

Directory	Purpose	Deploy path
hello/	Minimal Node HTTP + Dockerfile + /health	git-public · port 3000 · launch smoke default
oneclick/	One-click Blueprint (Dockerfile runtime)	remote Blueprint URL under /oneclick
static/	Static site upload (no build)	ZIP/folder upload of /static
vite-static/	Vite build → nginx static	git-public · port 8080
python-http/	Python stdlib HTTP	git-public · port 8000
go-http/	Go stdlib HTTP	git-public · port 8080
env-service/	Non-secret env injection demo	git-public · port 3000 · /api/config
compose-stack/	Docker Compose web + api	docker-compose · public port 8080
sandbox-agent/	Chat-to-app, human approval, and preview-to-promotion SDK flows	Appaloft 1.2+ · Private preview
sandbox-jobs/	Deterministic code, offline documents, and bounded script jobs without Promotion	Appaloft 1.2+ · Private preview

Sandbox Jobs

Use sandbox-jobs/ when a SaaS needs an isolated task result rather than a published application. The examples write inputs, execute existing code without Pi, read structured results, and terminate the Sandbox in finally.

Workload	Sandbox	Agent	Promotion
Existing script execution	✓	—	—
Natural-language analysis	✓	✓	—
Document processing	✓	Optional	—
Generate and publish an application	✓	✓	✓
Public-web crawler	Waiting for egress allowlist	—	—

Start with the Sandbox Jobs guide or open the code interpreter, document processor, and script runner directly.

Deploy hello (git-public)

appaloft resource create \
  --name example-hello \
  --source-kind git-public \
  --git-url https://github.com/appaloft/examples.git \
  --git-ref main \
  --base-directory /hello \
  --port 3000 \
  --health-path /health

Or Cloud Console → Quick Deploy → public Git → this repo → base directory hello.

One-click Blueprint

Manifest:

https://raw.githubusercontent.com/appaloft/examples/main/oneclick/appaloft.blueprint.yaml

Local smoke (all examples with scripts)

./scripts/smoke-all-local.sh

Each example also has ./scripts/smoke-local.sh (where applicable). Official Cloud launch smoke remains on hello.

Growth CTAs

Content	Destination
examples_repo_hero	www.appaloft.com
example_hello_console	Cloud Console
example_static_cta	Static-site guide

Design rules

1. Each example is a self-contained deploy unit under its own directory.
2. No Cloud commercial secrets or private package names.
3. Prefer small images and zero private dependencies for smoke hosts.
4. Keep official launch smoke on hello (baseDirectory=/hello).
5. Non-3000 ports, multi-language, env injection, and compose are covered by dedicated directories above.

License

MIT — see root LICENSE and per-example notes.