Fling

Small Software Platform — Build and deploy small apps and tools through conversation.

Watch the demo

What is Fling?

Fling is the fastest way from Claude Code to deployed software.

"I want a podcast feed that picks randomly between Hard Fork and The Daily each day, and gives me one episode per day."

Claude writes the code, runs it locally, tests it, and iterates until it works. You can watch the local server, see logs, check the database — but you don't have to.

The target user is anyone who can describe what they want. Technical users get the benefit of standard, portable code. Non-technical users get things built without knowing that code exists.

Quick Start

npx flingit

That's it. This creates a project at ~/fling, sets up the environment, and opens Claude Code. You're immediately in a conversation — just describe what you want to build.

Requires Node.js 22 or later.

Principles

• Small Software
• Super low friction
• You own the agent
• Batteries included

How It Works

Fling provides four primitives (more to come) that Claude uses to build your tools:

| Primitive | What it does | |-----------|--------------| | HTTP | Expose endpoints to the web (via Hono) | | Cron | Run code on a schedule | | Database | Store and query data (SQLite) | | Secrets | Manage API keys and credentials |

Everything works locally during development. When you're ready, just tell Claude Code to deploys to production.

Design Philosophy

1. Claude-first, not CLI-first — The user's interface is natural language. The CLI exists for Claude to operate.

2. Standard tools over custom abstractions — Hono for HTTP, SQLite for data, standard cron syntax. Claude already knows these.

3. Local-first development — Everything works and can be tested locally.

4. Fail fast — Missing secrets throw. Invalid syntax throws. Obvious errors help Claude debug.

Running Fling From Source

To run fling from this repo, just do

npm run cli

That's the equivalent of running npx flingit. It will also do the onboarding flow and create a Fling project, but the flingit dependency there will point to your local package instead of the public package on NPM.

Publishing

The package is published to npm as flingit. The prepublishOnly script runs lint, typecheck, build, and tests automatically.

npm publish

To do a dry run first:

npm pack --dry-run

Documentation

• ARCHITECTURE.md — How Fling works internally (CLI commands, runtime API, platform)
• API.md — Platform HTTP API reference
• DEPLOYMENT.md — How the Fling platform deploys
• SCRIPTS.md — All the scripts in this repo
• CLI.md — All the commands provided by the CLI
• SMOKE-TEST.md — What the smoke-test tests
• SPEC.md — Original product specification