flingit 0.0.25 → 0.0.26
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +23 -32
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -6,13 +6,15 @@
|
|
|
6
6
|
|
|
7
7
|
## What is Fling?
|
|
8
8
|
|
|
9
|
-
Fling is the fastest way from Claude Code to deployed software
|
|
9
|
+
Fling is the fastest way from Claude Code to deployed software, like:
|
|
10
10
|
|
|
11
|
-
> "
|
|
11
|
+
> "Make a Discord bot where my colleagues can RSVP for my monthly vibe-coding jam."
|
|
12
|
+
|
|
13
|
+
or
|
|
12
14
|
|
|
13
|
-
|
|
15
|
+
> "I want a podcast feed that picks randomly between Hard Fork and The Daily each day, and gives me one episode per day."
|
|
14
16
|
|
|
15
|
-
|
|
17
|
+
Claude writes the code, tests it, and deploys it for you. No tech choices, no friction, batteries included.
|
|
16
18
|
|
|
17
19
|
## Quick Start
|
|
18
20
|
|
|
@@ -26,10 +28,21 @@ Requires Node.js 22 or later.
|
|
|
26
28
|
|
|
27
29
|
## Principles
|
|
28
30
|
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
31
|
+
### Small Software
|
|
32
|
+
|
|
33
|
+
The future will be full of "small software": small, focused tools and fun apps you build for yourself, your family, friends, colleagues.
|
|
34
|
+
|
|
35
|
+
### Super low friction
|
|
36
|
+
|
|
37
|
+
Fling is designed to get out of your way as much as possible. Ideally you shouldn't even have to think about Fling at all.
|
|
38
|
+
|
|
39
|
+
### You own the agent
|
|
40
|
+
|
|
41
|
+
Fling does not box you in to a hosted agent you're not used to, can't configure, and that can't access your stuff. Use your own Claude Code (or Codex, ...).
|
|
42
|
+
|
|
43
|
+
### Batteries included
|
|
44
|
+
|
|
45
|
+
Frontend, backend, database, cron jobs, storage, Discord and Slack, without configuration, out of the box, and more is on the way.
|
|
33
46
|
|
|
34
47
|
## How It Works
|
|
35
48
|
|
|
@@ -37,11 +50,13 @@ Fling provides these primitives (more to come) that Claude uses to build your to
|
|
|
37
50
|
|
|
38
51
|
| Primitive | What it does |
|
|
39
52
|
|-----------|--------------|
|
|
53
|
+
| **Frontend** | Build React apps (via [Vite](https://vite.dev)) |
|
|
40
54
|
| **HTTP** | Expose endpoints to the web (via [Hono](https://hono.dev)) |
|
|
41
55
|
| **Cron** | Run code on a schedule |
|
|
42
56
|
| **Database** | Store and query data (SQLite) |
|
|
43
57
|
| **Secrets** | Manage API keys and credentials |
|
|
44
58
|
| **Storage** | Store and serve files (local or R2) |
|
|
59
|
+
| **Plugins** | Discord and Slack |
|
|
45
60
|
|
|
46
61
|
Everything works locally during development. When you're ready, just tell Claude Code to deploys to production.
|
|
47
62
|
|
|
@@ -55,30 +70,6 @@ Everything works locally during development. When you're ready, just tell Claude
|
|
|
55
70
|
|
|
56
71
|
4. **Fail fast** — Missing secrets throw. Invalid syntax throws. Obvious errors help Claude debug.
|
|
57
72
|
|
|
58
|
-
## Running Fling From Source
|
|
59
|
-
|
|
60
|
-
To run fling from this repo, just do
|
|
61
|
-
|
|
62
|
-
```bash
|
|
63
|
-
npm run cli
|
|
64
|
-
```
|
|
65
|
-
|
|
66
|
-
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.
|
|
67
|
-
|
|
68
|
-
## Publishing
|
|
69
|
-
|
|
70
|
-
The package is published to npm as `flingit`. The `prepublishOnly` script runs lint, typecheck, build, and tests automatically.
|
|
71
|
-
|
|
72
|
-
```bash
|
|
73
|
-
npm publish
|
|
74
|
-
```
|
|
75
|
-
|
|
76
|
-
To do a dry run first:
|
|
77
|
-
|
|
78
|
-
```bash
|
|
79
|
-
npm pack --dry-run
|
|
80
|
-
```
|
|
81
|
-
|
|
82
73
|
## Documentation
|
|
83
74
|
|
|
84
75
|
- [ARCHITECTURE.md](./ARCHITECTURE.md) — How Fling works internally (CLI commands, runtime API, platform)
|