femboyz.cloud

Self-hosted file hosting service - upload files or links, share them via short IDs, browse a public feed. TypeScript rewrite of femboyz-cloud-server.

• Uploads: raw file streams (multi-file, SHA-256 verified) and links
• Serving: short IDs like 123XABCD → link redirect or HTML/JSON/text preview, files by index
• Feed: public, newest-first, paginated
• Storage: flat filesystem named by content hash, deduplicated, usage-tracked with a hard size cap
• Frontend: SvelteKit 2 + Svelte 5 client in client/

Stack

• Fastify v5
• MongoDB
• Zod
• Pino
• SvelteKit

Running

npm run dev          # tsx, NODE_ENV=dev, debug logs
npm run build        # tsc → dist/
npm start            # NODE_ENV=prod node dist/index.js
npm test             # vitest

Env is read from .env.${NODE_ENV} (see .env.* for variables: MongoDB connection, ports, storage limits, AUTH_ADMIN_KEY, BASE_URL, etc.). Requires a running MongoDB instance.

API

Method	Path	Description
GET	/ping	Health check
GET	/api/v2/feed	Public uploads, newest-first, paginated (s, e)
POST	/api/v2/viewed/:id	Record a view
GET	/:id	Fetch upload by ID (link→302, files→HTML/JSON/text)
GET	/:id/:fid	Serve raw file by index
GET	/api/v2/maxfsize	Max accepted upload size right now
POST	/api/v2/udstream	File stream upload (X-Meta header + concatenated bytes)
POST	/api/v2/ulink	Link upload (JSON body)
GET	/api/v2/admin/uploads	(auth) Paginated/searchable upload inventory
DELETE	/api/v2/admin/uploads/:id	(auth) Permanent deletion
GET	/api/v2/admin/logs	(auth) Error log viewer

Wire formats are documented in AGENTS.md and schema/frontend_*.md.