# Build and publish with HTTPS.

Teenyapp is a managed hosting and backend platform for apps built with AI agents. A project includes a live Teenyapp subdomain and a teenybase backend. Agents can bootstrap a project with a single HTTP request; no local SDK or platform login is required to start.

## Create a project

Choose a unique slug: 3–49 lowercase letters, digits, and hyphens, starting and ending with a letter or digit. Read /skill.md for current validation rules and limits. Send a POST with no request body or authorization header. A name that is already taken returns 409.

```
curl -X POST "https://teenyapp.com/api/v1/new-project/your-unique-slug?template=empty"
```

## Follow the project briefing

The create response returns agent_link, preview_url, claim_url, and expires_at. Fetch agent_link next. Its project-specific instructions describe the file APIs, schema configuration, build and commit flow, and authentication.

A successful file save builds and publishes the app. The preview URL is https://{slug}.app.teenyapp.com; return it to the user after a successful build. Database schema changes require the commit step described in the briefing.

Give the user claim_url so they can claim the app before the 12-hour anonymous window expires. Keep the agent link and its project token private: they grant project access and do not belong in app HTML, public examples, or a repository.

## Use the included backend

Define tables and access rules in teenybase.ts. Teenybase generates table CRUD endpoints and schema migrations from that configuration. Use server-side Hono routes for app-specific behavior, authentication for app accounts, and file fields for stored uploads.

Your deployed app exposes its generated OpenAPI document at /api/v1/doc and its interactive API reference at /api/v1/doc/ui on the app’s own domain. Use the project briefing as the source of truth for the current API and lifecycle.

## Choose a starting point

The empty template is a starting point for a new app. The current template names are listed below directly from the server’s template registry. Browse the public app gallery for examples of tools built on Teenyapp.

Agents can request the gallery and this guide with Accept: text/markdown. /llms.txt links to the public product overview, skill, and gallery. The website URL is enough for a user to reference Teenyapp when asking an agent to build.

## Current templates

- `empty`
- `notes`

## Continue

- [Teenyapp](https://teenyapp.com/)
- [Explore apps](https://teenyapp.com/explore-all)
- [How it works](https://teenyapp.com/how-it-works)
- [Developer guide](https://teenyapp.com/developers)
- [Agent instructions](https://teenyapp.com/skill.md)