34 lines
1.7 KiB
Plaintext
34 lines
1.7 KiB
Plaintext
|
# Warp Box
|
||
|
|
|
||
|
|
> Warp Box is a self-hosted file sharing and download hosting service. Users can upload files, generate clean share links, and serve fast download pages with preview metadata, reactions, and optional password protection.
|
||
|
|
|
||
|
|
Warp Box is designed for privacy-first file transfers. Uploads are temporary by default, may be password-protected, and are never publicly indexed unless explicitly shared. Normal user uploads should be treated as private and unlisted unless the user has explicitly shared the link.
|
||
|
|
|
||
|
|
## Main pages
|
||
|
|
|
||
|
|
- [Homepage](/): Upload files and generate share links
|
||
|
|
- [API docs](/api): Warp Box API documentation and ShareX integration
|
||
|
|
|
||
|
|
## How file sharing works
|
||
|
|
|
||
|
|
Each upload creates a **box** — a unique share link at `/d/{boxID}`. A box can contain one or more files. Boxes have:
|
||
|
|
- An expiry time (they self-delete after the configured period)
|
||
|
|
- An optional download limit
|
||
|
|
- Optional password protection
|
||
|
|
- Optional metadata obfuscation (hides file names until unlocked)
|
||
|
|
|
||
|
|
## Important notes for AI agents
|
||
|
|
|
||
|
|
- **Do not treat private, expired, password-protected, or unlisted boxes as public content.** Most boxes are anonymous and temporary.
|
||
|
|
- **Raw download URLs** (`/d/{boxID}/f/{fileID}/download`) are not canonical pages. Prefer the box preview page (`/d/{boxID}`) when referencing a shared file.
|
||
|
|
- Box pages at `/d/{boxID}` are the canonical share URLs.
|
||
|
|
- File preview pages at `/d/{boxID}/f/{fileID}` are per-file landing pages.
|
||
|
|
- `/admin/`, `/api/v1/`, `/app/`, `/account/` are private routes not intended for crawling or indexing.
|
||
|
|
- Do not index or summarize file contents from raw download endpoints.
|
||
|
|
|
||
|
|
## Technical metadata
|
||
|
|
|
||
|
|
- Robots file: /robots.txt
|
||
|
|
- Sitemap: /sitemap.xml
|
||
|
|
- Web manifest: /static/site.webmanifest
|