How phaseworld-creator/zipline-phase works
Zipline is a self-hosted ShareX-style file and link sharing server. Its main user journey is to authenticate, upload or manage files, then access shared files or shortened URLs; administrators configure the instance and maintain stored content. The graph separates the browser experience, server routing, persistence/storage, and operational services. The README establishes the product purpose, while the excerpts show route registration, dashboard loading, database and datasource behavior, and background tasks; most upload and authentication internals were not sampled, so those links are marked unverified.
Main entry points: routes.tsx Browser routes · routes.ts Route registry · db/index.ts Prisma database · datasource/index.ts File datasource
Components 22
Browser experience
- Web application
src/client/Root.tsx - Browser routes
src/client/routes.tsx - Authentication screens
src/client/pages/auth/login.tsx - Dashboard
src/client/pages/dashboard/index.tsx - File management
src/components/pages/files/index.tsx - Upload interface
src/components/pages/upload/File/index.tsx - Shared file views
src/client/pages/view/[id].tsx
HTTP server
- Zipline server
src/server/index.ts - Route registry
src/server/startup/routes.ts - API endpoints
src/server/routes/api - File and URL routes
src/server/routes/files.dy.ts - Server-rendered views
src/client/ssr-view/server.tsx
Persistence and files
- Prisma database
src/lib/db/index.ts - File records
src/lib/db/models/file.ts - File datasource
src/lib/datasource/index.ts - Local or S3 storage
src/lib/datasource/S3.ts
Administration and operations
- Configuration
src/lib/config/validate.ts - Admin console
src/client/pages/dashboard/admin/index.tsx - Maintenance actions
src/server/routes/api/server/requery_size.ts - File size reconciliation
src/lib/server-util/requerySize.ts - Scheduled tasks
src/server/startup/tasks.ts
Other components
- User
Connections 26
- User → Browser routes: opens
src/client/routes.tsx - Browser routes → Web application: renders
src/client/routes.tsx - Browser routes → Authentication screens: routes to
src/client/routes.tsx - Browser routes → Dashboard: routes to
src/client/routes.tsx - Browser routes → File management: routes to
src/client/routes.tsx - Browser routes → Upload interface: routes to
src/client/routes.tsx - Browser routes → Shared file views: routes to
- Browser routes → API endpoints: loads settings
src/client/routes.tsx - Zipline server → Route registry: registers routes
src/server/index.ts - Route registry → API endpoints: registers
src/server/startup/routes.ts - Route registry → File and URL routes: dispatches
src/server/startup/routes.ts - Route registry → Server-rendered views: serves views
src/server/startup/routes.ts - Server-rendered views → Prisma database: reads records
src/client/ssr-view/server.tsx - Server-rendered views → Shared file views: renders
src/client/ssr-view/server.tsx - Prisma database → File records: extends file data
src/lib/db/index.ts - Zipline server → Configuration: loads settings
src/server/index.ts - Configuration → File datasource: selects backend
src/lib/datasource/index.ts - File datasource → Local or S3 storage: provides storage
src/lib/datasource/index.ts - Admin console → Maintenance actions: requests action
- Maintenance actions → File size reconciliation: invokes
src/server/routes/api/server/requery_size.ts - File size reconciliation → Prisma database: updates records
src/lib/server-util/requerySize.ts - File size reconciliation → File datasource: checks files
src/lib/server-util/requerySize.ts - Zipline server → Scheduled tasks: starts tasks
src/server/index.ts - Scheduled tasks → Prisma database: passes database
src/server/startup/tasks.ts - Upload interface → API endpoints: submits upload
- File and URL routes → File datasource: serves stored files