How openprx/fenfa works
Fenfa is a self-hosted, multi-platform app distribution service. An administrator uploads a build, manages products and variants, and publishes releases; end users visit a product page, select a platform build, and download or follow iOS device-registration flows. The Go server routes public and admin requests to handlers backed by SQLite, with optional S3-compatible storage and Apple Developer integration. The graph includes the documented admin capabilities for analytics, events, exports, devices, and settings. Some handler-to-endpoint wiring is unsampled, so uncertain links are omitted or marked unverified.
Main entry points: router.ts Admin page routes · main.ts Public product page · handlers HTTP handlers · main.go Server startup
Components 26
Go service
- Server startup
cmd/server/main.go - Configuration
internal/config/config.go - HTTP router
internal/server/router.go - Auth middleware
internal/server/middleware/auth.go - HTTP handlers
internal/server/handlers - SQLite database
internal/store/models.go
App distribution
- Public product page
web/front/src/main.ts - Build upload
internal/server/handlers/upload.go - Package metadata parsing
internal/server/handlers/parse_app.go - Products and releases
internal/server/handlers/products_admin.go - Product API
internal/server/handlers/products_api.go - iOS device binding
internal/server/handlers/udid.go - Usage events
internal/server/handlers/events.go
Admin console
- Admin application
web/admin/src/App.vue - Admin page routes
web/admin/src/router.ts - Product management UI
web/admin/src/pages/AppsPage.vue - Upload UI
web/admin/src/pages/UploadPage.vue - Stats and events UI
web/admin/src/pages/StatsPage.vue - Device management UI
web/admin/src/pages/UdidPage.vue - Settings UI
web/admin/src/pages/SettingsPage.vue - Export UI
web/admin/src/pages/ExportPage.vue - Product data cache
web/admin/src/composables/useProducts.ts
External services
- S3-compatible storage
internal/s3/client.go - Apple Developer API
internal/apple/client.go
Other components
- Administrator
- App recipient
Connections 26
- Server startup → Configuration: loads
cmd/server/main.go - Server startup → SQLite database: opens and migrates
cmd/server/main.go - Server startup → HTTP router: registers routes
cmd/server/main.go - HTTP router → Auth middleware: uses middleware
internal/server/router.go - HTTP router → HTTP handlers: routes requests
internal/server/router.go - App recipient → Public product page: visits
README.md - Public product page → Product API: fetches product
web/front/src/main.ts - Public product page → iOS device binding: checks UDID status
web/front/src/main.ts - Public product page → Usage events: reports visits
web/front/src/main.ts - Public product page → HTTP handlers: downloads releases
README.md - Administrator → Admin application: manages releases
README.md - Admin application → Admin page routes: renders pages
web/admin/src/App.vue - Admin page routes → Product management UI: routes to
web/admin/src/router.ts - Admin page routes → Upload UI: routes to
web/admin/src/router.ts - Admin page routes → Stats and events UI: routes to
web/admin/src/router.ts - Admin page routes → Device management UI: routes to
web/admin/src/router.ts - Admin page routes → Settings UI: routes to
web/admin/src/router.ts - Admin page routes → Export UI: routes to
web/admin/src/router.ts - Admin application → Product data cache: loads products
web/admin/src/App.vue - Product data cache → HTTP handlers: requests admin API
- Product management UI → HTTP handlers: manages products
- Upload UI → Build upload: submits builds
- Build upload → Package metadata parsing: extracts metadata
- HTTP handlers → SQLite database: reads and writes
- Build upload → S3-compatible storage: stores files
- iOS device binding → Apple Developer API: registers devices