flingit 0.0.49 → 0.0.50
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/package.json
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
|
|
1
|
+
56ff0f95fb32f366e828b1f9b58a4c30
|
|
@@ -138,7 +138,7 @@ Always use `npx` to run the project's installed Fling (not global).
|
|
|
138
138
|
**Important:** The CLI must be called without a TTY (e.g., with stdout redirected), or with the `--cli` flag. When both stdin and stdout are a TTY and `--cli` is not passed, the CLI launches an interactive mode instead of executing commands. If you are running from an environment where a TTY may be present, always pass `--cli`:
|
|
139
139
|
|
|
140
140
|
```bash
|
|
141
|
-
npx fling --
|
|
141
|
+
npx fling --cli push # Safe from any environment
|
|
142
142
|
```
|
|
143
143
|
|
|
144
144
|
```bash
|
|
@@ -173,13 +173,13 @@ Each cron invocation logs "Running cron job <name>" at the start. To see all log
|
|
|
173
173
|
|
|
174
174
|
1. **Find the invocation** by searching for the cron job name:
|
|
175
175
|
```bash
|
|
176
|
-
npx fling --
|
|
176
|
+
npx fling --prod logs --search "Running cron job daily-cleanup"
|
|
177
177
|
```
|
|
178
178
|
This shows log entries with Ray IDs like `[ray:abc12345]`.
|
|
179
179
|
|
|
180
180
|
2. **Filter by that Ray ID** to see all logs from that invocation:
|
|
181
181
|
```bash
|
|
182
|
-
npx fling --
|
|
182
|
+
npx fling --prod logs --ray abc12345
|
|
183
183
|
```
|
|
184
184
|
|
|
185
185
|
### Local vs Production (`--prod`)
|
|
@@ -194,11 +194,11 @@ npx fling db sql "SELECT 1" # Local SQLite
|
|
|
194
194
|
npx fling storage list # Local storage
|
|
195
195
|
|
|
196
196
|
# Production (requires login)
|
|
197
|
-
npx fling --
|
|
198
|
-
npx fling --
|
|
199
|
-
npx fling --
|
|
200
|
-
npx fling --
|
|
201
|
-
npx fling --
|
|
197
|
+
npx fling --prod secret list # Deployed secrets
|
|
198
|
+
npx fling --prod logs # Deployed logs
|
|
199
|
+
npx fling --prod db sql "SELECT 1" # Deployed D1
|
|
200
|
+
npx fling --prod storage list # R2 storage
|
|
201
|
+
npx fling --prod cron list # Deployed cron jobs
|
|
202
202
|
```
|
|
203
203
|
|
|
204
204
|
**Note:** Production logs have a delay of ~10 seconds or more before they appear.
|
|
@@ -230,7 +230,7 @@ After each deploy, tell the user what the deployed URL is. With Fling, to deplo
|
|
|
230
230
|
|
|
231
231
|
### After First Deployment
|
|
232
232
|
|
|
233
|
-
After your first `fling
|
|
233
|
+
After your first `fling it`, consider asking the user if they want a custom URL.
|
|
234
234
|
Their project was auto-assigned a slug like `proj-abc123`.
|
|
235
235
|
|
|
236
236
|
To change it: `npx fling project slug:set my-custom-slug`
|
|
@@ -246,36 +246,36 @@ If the user isn't logged in (no token stored), help them authenticate:
|
|
|
246
246
|
|
|
247
247
|
**New user:** Sign up with email and name:
|
|
248
248
|
```bash
|
|
249
|
-
npx fling --
|
|
249
|
+
npx fling --cli signup --email user@example.com --name "User Name"
|
|
250
250
|
```
|
|
251
251
|
|
|
252
252
|
**Existing user:** Log in via magic link email:
|
|
253
253
|
```bash
|
|
254
|
-
npx fling --
|
|
254
|
+
npx fling --cli login --email user@example.com
|
|
255
255
|
```
|
|
256
256
|
After running login, tell the user to check their email and click the login link.
|
|
257
257
|
The CLI will wait until the link is clicked, then complete login automatically.
|
|
258
258
|
|
|
259
|
-
|
|
259
|
+
DO NOT ASK THE USER TO RUN THESE COMMAND THEMSELVES. You have bash access, run them directly, unless they ask explicitly.
|
|
260
260
|
|
|
261
261
|
### Email Verification
|
|
262
262
|
|
|
263
263
|
After signing up, you must verify your email to deploy.
|
|
264
|
-
If `fling
|
|
264
|
+
If `fling it` fails with "Email verification required":
|
|
265
265
|
|
|
266
266
|
1. Run `fling verify` to check verification status
|
|
267
267
|
2. Run `fling verify --resend` to resend the verification email
|
|
268
268
|
3. **Tell the user they need to check their email and click the verification link.** You cannot do this step for them — they must open their inbox, find the email from Fling, and click the link. Wait for them to confirm they have done this before proceeding.
|
|
269
|
-
4. Retry `fling
|
|
269
|
+
4. Retry `fling it` after the user confirms they clicked the link
|
|
270
270
|
|
|
271
|
-
### What `fling
|
|
271
|
+
### What `fling it` does:
|
|
272
272
|
|
|
273
273
|
1. **Builds frontend** - Runs `vite build`, outputs to `dist/client/`
|
|
274
274
|
2. **Uploads static assets** - HTML, JS, CSS, images from `dist/client/`
|
|
275
275
|
3. **Bundles backend** - Compiles `src/worker/index.ts` with esbuild
|
|
276
276
|
4. **Deploys to Cloudflare** - Both frontend and backend go live
|
|
277
277
|
|
|
278
|
-
**Secrets:** Always stored locally in `.fling/secrets`. Use `fling
|
|
278
|
+
**Secrets:** Always stored locally in `.fling/secrets`. Use `fling it` to deploy secrets to production along with your code.
|
|
279
279
|
|
|
280
280
|
### Static Asset Limits
|
|
281
281
|
|
|
@@ -328,7 +328,7 @@ This gives collaborators:
|
|
|
328
328
|
|
|
329
329
|
7. **Use /api prefix for backend routes** - Required for Vite proxy during development.
|
|
330
330
|
|
|
331
|
-
8. **Run commands yourself** - You have bash access. Don't ask the user to run `fling
|
|
331
|
+
8. **Run commands yourself** - You have bash access. Don't ask the user to run `fling it`, `fling dev`, `npm start`, etc. Execute them directly.
|
|
332
332
|
|
|
333
333
|
9. **Reserved paths (`/__*`)** - Paths starting with `/__` are reserved for internal platform use (e.g., `/__cron` for cron jobs). Do not create routes with these prefixes.
|
|
334
334
|
|