Skip to content

Commit 58446b9

Browse files
Public README. No private notes.
Topics and clone URL stay. The old login line is gone.
1 parent 07656a1 commit 58446b9

6 files changed

Lines changed: 34 additions & 38 deletions

File tree

HOW-TO-PLAY.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
Ninety seconds. One pack. One card.
44

5-
Live booth: [first-bucket-studios.vercel.app](https://first-bucket-studios.vercel.app) — a real tab, so Save works. This nested preview can swallow the download.
5+
Live booth: [first-bucket-studios.vercel.app](https://first-bucket-studios.vercel.app)open it in a real tab so Save works.
66

77

88
## The loop

README.md

Lines changed: 14 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -6,13 +6,9 @@ Basketball pack · NBA · WNBA · sports cards · holographic foil · WebGL · 8
66

77
A browser basketball pack you can fork. Not a shop. Not a sportsbook. Not the NBA.
88

9-
**Live booth:** [first-bucket-studios.vercel.app](https://first-bucket-studios.vercel.app)
10-
(GitHub stays private. Domain later.)
9+
**Play:** [first-bucket-studios.vercel.app](https://first-bucket-studios.vercel.app)
1110

12-
[Play](HOW-TO-PLAY.md) · [Install](#install) · [Contribute](CONTRIBUTING.md) · [MIT](LICENSE)
13-
14-
Private: [github.com/DigitalCurrensy/first-bucket-studios](https://github.com/DigitalCurrensy/first-bucket-studios)
15-
(log in as DigitalCurrensy — not the older `first-bucket-studio`, no *s*)
11+
[How to play](HOW-TO-PLAY.md) · [Fork it](FORK.md) · [Contribute](CONTRIBUTING.md) · [MIT](LICENSE)
1612

1713
---
1814

@@ -43,18 +39,20 @@ Tape: [docs/tape/demo.mp4](docs/tape/demo.mp4)
4339
| **Rip the pack** | New room. New ten. |
4440
| **Lock five** | 82 nights from those names. |
4541
| **Save the card** | `first-bucket-{team}-{wins}.png` |
46-
| **Share** | System share sheet, or the tray on desktop. |
42+
| **Share** | Phone: system share sheet. Desktop: the tray. |
4743
| **Pin this walk** | Keeps it on the rail. Nothing is pinned until you pin it. |
48-
| **X / TikTok / Snapchat / Reddit / Discord** | In the share tray. |
44+
| **X / Threads / Reddit / Facebook / WhatsApp / Telegram / LinkedIn** | Opens that app with the walk. |
45+
| **Discord** | Copies the walk, then opens Discord. Paste it. |
46+
| **TikTok / Snapchat / Instagram** | Saves a 9:16 plate, copies the caption, opens the app. |
4947
| **Copy the walk** | Public `/walk/v1.…` — paste it anywhere. |
5048
| **Open the walk** | Same five, same nights, forever. |
5149

5250
There is no “copy image.” The file is the card. The URL is the walk.
5351

54-
The pinned walk (optional) is Thunder 51–31. The door is the live pack.
52+
House demo (optional, not pinned): Thunder 51–31.
5553

5654
```
57-
/walk/v1.OKC.positionless.even.51.chet~dort~hartenstein~jalenw~sga
55+
https://first-bucket-studios.vercel.app/walk/v1.OKC.positionless.even.51.chet~dort~hartenstein~jalenw~sga
5856
```
5957

6058
---
@@ -70,7 +68,7 @@ npm install
7068
npm run dev
7169
```
7270

73-
Then rip. If Save is swallowed, you are in a nested preview — open a top-level tab.
71+
Open a real browser tab so Save works. Some embeds swallow the download.
7472

7573
```bash
7674
npm run test:pin # mixer lock + walk + stream-json
@@ -89,10 +87,10 @@ The house pin must stay green. That is the lock test.
8987
| [HOW-TO-PLAY.md](HOW-TO-PLAY.md) | The ninety seconds |
9088
| [docs/TESTING.md](docs/TESTING.md) | E2E layers |
9189
| [docs/STREAM-JSON.md](docs/STREAM-JSON.md) | NDJSON eval pipe |
92-
| [docs/BENCHMARKS.md](docs/BENCHMARKS.md) | Pin + visual loop (not VLMEvalKit) |
90+
| [docs/BENCHMARKS.md](docs/BENCHMARKS.md) | Pin + visual loop |
9391
| [docs/ANALYTICS.md](docs/ANALYTICS.md) | Booth funnel. Local. |
9492
| [docs/WALK.md](docs/WALK.md) | Walk certificate |
95-
| [docs/STUDIO.md](docs/STUDIO.md) | Rooms, themes, updates, performance |
93+
| [docs/STUDIO.md](docs/STUDIO.md) | Rooms, themes, performance |
9694
| [FORK.md](FORK.md) | Copy the loop. Swap the sport. |
9795
| [NOTICE](NOTICE) | MIT is the code, not the names |
9896
| [SUPPORT.md](SUPPORT.md) | How to ask |
@@ -103,19 +101,15 @@ The house pin must stay green. That is the lock test.
103101

104102
**Themes.** Night arena (default) or light studio. Rail toggle. Reduced motion skips the ticker.
105103

106-
**Stream-JSON.** One object per line on stdout from `npm run test:demo`. Beats, then a walk, then a result. Same *pipe* as Claude’s stream-json. Different *types*. [docs/STREAM-JSON.md](docs/STREAM-JSON.md).
107-
108-
**Specialists.** Live pack, house pack, walk, foil, lithograph, tray, plates. One room per PR.
104+
**Stream-JSON.** One object per line on stdout from `npm run test:demo`. Beats, then a walk, then a result.
109105

110106
**GitHub Action.** [`.github/workflows/pin.yml`](.github/workflows/pin.yml) runs `test:pin` and `test:vl` on every push.
111107

112-
**Benchmarks.** Pin = Thunder 51–31. Visual loop = stills stay night stock (Y < 80). We do not run MMBench. [docs/BENCHMARKS.md](docs/BENCHMARKS.md).
113-
114108
---
115109

116110
## Community
117111

118-
Talk happens in **[GitHub Discussions](https://github.com/DigitalCurrensy/first-bucket-studios/discussions)**. There is no Discord.
112+
Talk happens in **[GitHub Discussions](https://github.com/DigitalCurrensy/first-bucket-studios/discussions)**.
119113

120114
| Category | Use it for |
121115
| --- | --- |
@@ -124,7 +118,7 @@ Talk happens in **[GitHub Discussions](https://github.com/DigitalCurrensy/first-
124118
| **Show and tell** | Forks, other sports, stills |
125119
| **Announcements** | Releases from the maintainers |
126120

127-
For a good Q&A answer fast, include the walk URL if you have one, your OS and browser, how you ran it, and whether Save was in a top-level tab or a nested preview. See [SUPPORT.md](SUPPORT.md). Bugs belong in issues. Security reports follow [SECURITY.md](SECURITY.md), never a public thread.
121+
Bugs belong in issues. Security reports follow [SECURITY.md](SECURITY.md), never a public thread.
128122

129123
---
130124

SUPPORT.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -9,16 +9,16 @@ There is no Discord. There is no support email. This desk is the repo.
99
## For a good Q&A answer fast, include
1010

1111
- The walk URL if you have one (`/walk/v1.…`)
12-
- OS and browser (and whether you were in a nested preview or a top-level tab)
13-
- How you ran it (`npm run dev`, a fork, the live preview)
12+
- OS and browser (and whether you were in an iframe or a real tab)
13+
- How you ran it (`npm run dev`, a fork, the live booth)
1414
- What you clicked, in order
1515
- What you expected, what you got
1616

1717
Do not paste secrets. Walks are public certificates; they are safe to share.
1818

1919
## Save did not download
2020

21-
Save is a native file link (`<a download>` with a PNG data URL). A nested preview can swallow it. Open the live booth in a top-level tab, then Save. Copy the walk still works in the frame.
21+
Save is a native file link (`<a download>` with a PNG data URL). An iframe can swallow it. Open the live booth in a real tab, then Save. Copy the walk still works in the frame.
2222

2323
## Share on social did nothing
2424

docs/ANALYTICS.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,7 @@ Copy without Save still counts. The URL is the certificate.
5656

5757
## Honest host limits
5858

59-
Inside a nested preview, the host may swallow `<a download>`. Funnel will show `tray` and maybe `copy`, not `save`. That is the host, not a lying button. Test Save in a top-level tab.
59+
Inside an iframe, the host may swallow `<a download>`. Funnel will show `tray` and maybe `copy`, not `save`. That is the host, not a lying button. Test Save in a real tab.
6060

6161
## What we will not add
6262

docs/TESTING.md

Lines changed: 6 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -20,26 +20,20 @@ GitHub Action **Pin** runs layers 1 and 3 on every push to `main`. Layer 4 needs
2020

2121
| Piece | Status | Notes |
2222
| --- | --- | --- |
23-
| Home pack | Ready | Night stock + emblem. CSS hologram in a nested preview. |
23+
| Home pack | Ready | Night stock + emblem. CSS hologram inside an iframe. |
2424
| Live 82-0 pack | Ready | Random franchise. Tear. Ten plates. Not Thunder every time. |
2525
| Player cards | Ready | One 5×7 face. Night plate. Pick five. Court back only when face-down. |
2626
| House pin | Ready | Thunder 51–31, same walk every time. Optional. |
2727
| Send PNG | Ready in a top-level tab | **Save the card** is a real `<a download>`. **Share** is Web Share, then the tray. |
28-
| Social | Ready | X, Threads, Reddit, Facebook, TikTok, Snapchat, Discord. |
28+
| Social | Ready | X, Threads, Reddit, Facebook, WhatsApp, Telegram, LinkedIn, Discord, TikTok, Snapchat, Instagram. |
2929
| Pins | Ready | Empty until the user pins. Thunder is not auto-pinned. |
3030
| Pin tests | Must stay green | `npm run test:pin` then `npm run test:vl` |
31-
| Public URL | Ready | [first-bucket-studios.vercel.app](https://first-bucket-studios.vercel.app). GitHub stays private. Domain later. |
31+
| Public URL | Ready | [first-bucket-studios.vercel.app](https://first-bucket-studios.vercel.app) |
3232

3333
### Host limits (not product bugs)
3434

35-
- **Save inside this nested preview** can be swallowed by the host. Open the live booth, then Save.
36-
- **WebGL foil** stays off in a host iframe / sandbox so the pack is never a white rectangle. CSS hologram is the foil here. The live booth gets GL.
37-
38-
### Still missing for a named booth
39-
40-
1. A custom domain. The live URL is `first-bucket-studios.vercel.app` until you buy one.
41-
2. One rip, not two. Home poster then 82-0 foil is the current door.
42-
3. Save must be tested in a **top-level** tab (the live booth). Nested preview cannot prove the download.
35+
- **Save inside an iframe** can be swallowed by the host. Open the live booth in a real tab, then Save.
36+
- **WebGL foil** stays off in a nested iframe so the pack is never a white rectangle. CSS hologram is the foil there. The live booth gets GL.
4337

4438
Do not ship a cream pack, a Thunder-only live pull, stacked card faces, or a tray that toasts instead of saving.
4539

@@ -102,4 +96,4 @@ Rewrites `docs/stills/01-home.jpg` … `04-tray.jpg` and `docs/tape/demo.mp4`. C
10296

10397
## Filing a bug from a failed loop
10498

105-
See [SUPPORT.md](../SUPPORT.md). Include the walk URL, browser, and whether you were in a nested preview.
99+
See [SUPPORT.md](../SUPPORT.md). Include the walk URL, browser, and whether you were in an iframe.

package.json

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,14 @@
33
"private": true,
44
"license": "MIT",
55
"description": "Rip a basketball pack. Ten cards. Five names. Eighty-two nights. Send the card.",
6+
"homepage": "https://first-bucket-studios.vercel.app",
7+
"repository": {
8+
"type": "git",
9+
"url": "git+https://github.com/DigitalCurrensy/first-bucket-studios.git"
10+
},
11+
"bugs": {
12+
"url": "https://github.com/DigitalCurrensy/first-bucket-studios/issues"
13+
},
614
"keywords": [
715
"basketball",
816
"nba",
@@ -15,7 +23,7 @@
1523
"pack-opener",
1624
"react",
1725
"typescript",
18-
"tanstack-start",
26+
"javascript",
1927
"vite",
2028
"simulation",
2129
"collector"

0 commit comments

Comments
 (0)