Fling

Small Software Platform - build and deploy small apps and tools through conversation.

This README is the high-level entrypoint only. Exact CLI syntax lives in CLI.md, exact HTTP endpoint shapes live in API.md, and the other docs link back to those sources instead of re-stating them.

• Join the waitlist for early access
• Chat with us on Discord

What It Is

Fling is the fastest path from an agent session to running software. You describe the tool you want, the agent writes it, tests it, and deploys it.

Typical examples:

"Make a Discord bot where my colleagues can RSVP for my monthly vibe-coding jam."

"I want a podcast feed that picks randomly between Hard Fork and The Daily each day."

Fling ships the standard primitives the agent needs to do that:

| Primitive | What it does | |-----------|--------------| | Frontend | React app via Vite | | HTTP | Web routes via Hono | | Cron | Scheduled jobs | | Database | SQLite locally, D1 in production | | Secrets | Local and deployed secret management | | Storage | Local filesystem or R2 | | Email | Send and receive transactional email | | Plugins | Discord and Slack |

Quick Start

npx flingit

That creates a project at ~/flings/my-first-fling, sets up the environment, and opens Claude Code. Requires Node.js 22 or later.

Principles

1. Claude-first, not CLI-first. Natural language is the user interface; the CLI exists so agents can operate the platform.
2. Standard tools over custom abstractions. Hono, SQLite, cron syntax, and normal TypeScript keep the system legible.
3. Local-first development. The same primitives work locally before deployment.
4. Fail fast. Missing secrets, invalid config, and deployment errors should surface immediately and with context.

Documentation Map

• CLI.md - Authoritative command reference for fling, fling-admin, and fling-infra
• API.md - Authoritative platform HTTP API reference
• ARCHITECTURE.md - Runtime, platform, and data-flow design
• DEPLOYMENT.md - Operational deployment setup and environment requirements
• SMOKE-TEST.md - Smoke, local-test, and integration-test coverage and workflow
• SCRIPTS.md - Standalone scripts in scripts/