@profullstack/builtindie 0.0.0-stage → 0.1.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Profullstack, Inc. (moshcoder)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/OpenStack.md

@@ -0,0 +1,74 @@
+# built.indie
+
+- **Kind**: product
+- **Web**: https://built.indie.pit.world
+- **Repo**: https://github.com/moshcoder/built.indie
+- **Operator**: https://built.indie.pit.world/.well-known/openprofile.md
+- **License**: MIT
+- **Updated**: 2026-10-19
+
+Launch your indie product with one URL: we read the homepage and the LogicSRC files it serves, keep the pictures, and put it on a daily upvote board.
+
+## Languages
+
+- TypeScript 5: everything, ES modules
+
+## Runtimes
+
+- Bun 1.4: the server, the CLI, the TUI and the MCP server
+- Browser: the PWA (service worker, manifest)
+
+## Interfaces
+
+### Web
+
+- Hono 4: server-rendered pages, no client framework
+- public/app.js: votes, copy buttons, progress, service worker
+
+### API
+
+- Hono 4: JSON under /api/v1, OpenSite index calls under /api/v1/sites
+
+### CLI
+
+- @profullstack/builtindie: `builtindie`
+
+### TUI
+
+- @profullstack/hqtui: the board in a terminal
+
+### MCP
+
+- @modelcontextprotocol/sdk 1: stdio, zod 3 schemas
+
+## Data
+
+- SQLite (bun:sqlite): one file, WAL
+- Files: pictures beside the database, checked by their first bytes
+
+## Services
+
+- CoinPay: crypto payments for Featured
+- Resend: sign-in links
+- crawlproof: analytics and ads
+- Headless Chrome: homepage screenshots, run as nobody
+- pit.world relay: the address everyone without Moshpit DNS uses
+
+## Specs
+
+- OpenSite 0.1: every product is a record; we are a reader and an index
+- OpenProfile 0.4: products are organizations, makers are people
+- OpenStack.md 0.1: read from products, served about ourselves
+- OpenSaaS 0.1: plans and the cancel page, read from products
+- OpenIcon 0.1: the reference set, a vendored subset
+
+## Hosting
+
+- dev2 (bare metal): systemd unit built-indie, nginx, OpenInstall bin/install.sh
+- Moshpit name built.indie, certificate from the Moshpit registry
+
+## Never
+
+- No Stripe: payments are CoinPay
+- No client-side framework, no bundler
+- No secrets in .env files: app.env is written from the vault

package/README.md

@@ -1,3 +1,64 @@
-# Temporary Holding Version
+# built.indie
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Launch your indie product with one URL. **https://built.indie.pit.world** (on Moshpit DNS: https://built.indie)
+
+Paste a URL and built.indie reads the homepage the way a careful person would: the name, tagline and description, the logo, the card image, screenshots from the page plus one we take ourselves with headless Chrome, YouTube/Vimeo/Loom/mp4 videos, social accounts, `llms.txt`, the web manifest and JSON-LD. It also reads the [LogicSRC](https://logicsrc.com/specs) files a site may serve about itself:
+
+| file | spec | we show |
+| --- | --- | --- |
+| `/.well-known/opensite.json` | [OpenSite](https://logicsrc.com/docs/opensite) | what the site says it is; wins over what we scrape; `index.allow: false` is honoured |
+| `/.well-known/openprofile.md` | [OpenProfile](https://logicsrc.com/docs/openprofile) | the company (`Kind: organization`) and its accounts |
+| `/.well-known/openstack.md` | [OpenStack.md](https://logicsrc.com/docs/openstack) | "Built with" |
+| `/.well-known/opensaas.json` | [OpenSaaS](https://logicsrc.com/docs/opensaas) | plans, trial, and the cancel page |
+| `/.well-known/openicon.json` | [OpenIcon](https://logicsrc.com/docs/openicon) | that it publishes an icon set |
+
+Then it goes on today's board. People upvote (one per visitor). The board resets at midnight UTC; yesterday's winners get "#1 Product of the day" on their page and badge.
+
+**Free to launch, no account.** Anyone can launch any site. To edit a listing, sign in (an emailed link) and **claim** it by adding a DNS TXT record, `_built-indie.<domain>` → `built-indie-verify=<token>`. A signed-in submitter can edit until the owner claims it.
+
+Viral bits: a live badge with the upvote count (`/badge/<slug>.svg`) that turns a link back into a followed link and a ✓ once we see it on the homepage, share buttons, an OG card per product, RSS, and an optional crypto-paid **Featured** slot (CoinPay).
+
+Every product is published back as an OpenSite record (`/p/<slug>/opensite.json`) and an OpenProfile (`/p/<slug>/openprofile.md`); makers are OpenProfiles too (`/makers/<id>/openprofile.md`). Icons are the [OpenIcon](https://github.com/profullstack/openicon) reference set.
+
+## Surfaces
+
+```sh
+curl -fsSL https://built.indie.pit.world/install.sh | sh
+
+builtindie                       # TUI: today's board, ←/→ boards, v upvote, l launch
+builtindie launch yourproduct.com
+builtindie top week
+builtindie show linear
+builtindie vote linear
+builtindie preview any.site --json
+BUILTINDIE_KEY=bi_… builtindie claim linear   # prints the TXT record, then checks it
+BUILTINDIE_KEY=bi_… builtindie edit linear --tagline "…"
+
+claude mcp add builtindie -- bunx @profullstack/builtindie mcp
+```
+
+The web app is a PWA (manifest + service worker). The JSON API is under `/api/v1` and documented at `/help`; the OpenSite index calls are `GET /api/v1/sites?url=` and `POST /api/v1/sites`.
+
+## Run your own
+
+```sh
+bun install
+BUILTINDIE_KEY=$(openssl rand -hex 32) bun src/server.ts   # http://127.0.0.1:8798
+bun test
+```
+
+| env | |
+| --- | --- |
+| `BUILTINDIE_KEY` | required: keys vote hashes and claim tokens |
+| `BUILTINDIE_ORIGIN` | public address (default https://built.indie.pit.world) |
+| `BUILTINDIE_DATA` | where the database and pictures live (default ~/.local/share/built-indie) |
+| `BUILTINDIE_ADMIN_KEY` | bearer that may take a listing down |
+| `RESEND_API_KEY`, `MAIL_FROM` | sign-in mail; without them the link is logged |
+| `COINPAY_API_KEY`, `COINPAY_BUSINESS_ID`, `COINPAY_WEBHOOK_SECRET` | Featured payments |
+| `FEATURE_USD`, `FEATURE_DAYS` | price and length of Featured (19, 7) |
+| `BUILTINDIE_CHROME` | Chrome path, or `off`; `BUILTINDIE_SCREENSHOTS=off` skips screenshots |
+| `CRAWLPROOF_SITE`, `CRAWLPROOF_AD_SLOT` | analytics and ads; `off` turns either off |
+
+Production runs on dev2 under `bin/install.sh` (OpenInstall); every merge to main deploys. See `OpenStack.md`.
+
+MIT. Part of the [Moshpit ring](https://pit.world/ring).

package/bin/builtindie

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+import { main } from '../src/cli.ts'
+process.exitCode = await main()

package/package.json

@@ -1,6 +1,37 @@
 {
   "name": "@profullstack/builtindie",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.3",
+  "description": "built.indie: launch your indie product with one URL. We fetch the logo, screenshots, videos, llms.txt, OpenSite and OpenProfile from your homepage; people upvote; you get a badge. Web (PWA), API, CLI, TUI and MCP.",
+  "license": "MIT",
+  "type": "module",
+  "homepage": "https://built.indie.pit.world",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/moshcoder/built.indie.git"
+  },
+  "bin": {
+    "builtindie": "bin/builtindie"
+  },
+  "files": ["bin/builtindie", "src", "public", "OpenStack.md", "README.md", "LICENSE"],
+  "engines": {
+    "bun": ">=1.1"
+  },
+  "scripts": {
+    "start": "bun src/server.ts",
+    "dev": "bun --watch src/server.ts",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.17.0",
+    "@profullstack/coinpay-onboard": "^0.1.1",
+    "@profullstack/hqtui": "^0.10.3",
+    "@profullstack/openprofile": "^0.2.0",
+    "hono": "^4.13.13",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.4.3",
+    "typescript": "^7.0.2"
+  }
+}

package/public/app.js

@@ -0,0 +1,35 @@
+// built.indie: vote without a page load, copy buttons, progress while we read a site, the service worker.
+document.addEventListener('click', async (e) => {
+  const copy = e.target.closest('[data-copy]')
+  if (copy) {
+    e.preventDefault()
+    navigator.clipboard?.writeText(copy.dataset.copy).then(() => {
+      const was = copy.textContent
+      copy.textContent = 'Copied'
+      setTimeout(() => { copy.textContent = was }, 1500)
+    })
+    return
+  }
+  const vote = e.target.closest('[data-vote]')
+  if (!vote) return
+  e.preventDefault()
+  if (vote.classList.contains('voted')) return
+  vote.classList.add('voted', 'bump')
+  const count = vote.querySelector('.count')
+  count.textContent = String(Number(count.textContent) + 1)
+  try {
+    const r = await fetch('/p/' + encodeURIComponent(vote.dataset.vote) + '/vote', { method: 'POST', headers: { accept: 'application/json' } })
+    if (r.ok) count.textContent = String((await r.json()).votes)
+  } catch {}
+})
+document.addEventListener('submit', (e) => {
+  const form = e.target
+  if (form.dataset.confirm && !confirm(form.dataset.confirm)) return e.preventDefault()
+  if (!form.dataset.busy || form.classList.contains('busy')) return
+  form.classList.add('busy')
+  const note = document.createElement('p')
+  note.className = 'busy-note'
+  note.textContent = form.dataset.busy
+  form.append(note)
+})
+if ('serviceWorker' in navigator) navigator.serviceWorker.register('/sw.js').catch(() => {})

package/public/favicon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64"><rect width="64" height="64" rx="14" fill="#0b0a10"/><path d="M32 9 11 35h14v20h14V35h14z" fill="#ff5c39"/></svg>