How ccawmiku/subboost-cf-personal works
SubBoost converts subscription links, node links, and configuration files into enhanced Clash/Mihomo YAML, with a visual editor for node processing, proxy groups, routing, and DNS. The principal workflow runs from user-managed sources through parsing and configuration editing to YAML generation and optional subscription delivery. The application also manages saved subscriptions, templates, authentication, and scheduled refreshes. The graph combines README-documented capabilities with the sampled UI and local API code; unsampled subsystem wiring is shown only where the tree or documentation supports it.
Main entry points: config-store.ts Config store · generator/index.ts Mihomo generator · yaml.ts YAML output · parser/index.ts Source parsers
Components 26
Visual configuration
- Home workflow
packages/ui/src/product/home/home-surface.tsx - Source controls
packages/ui/src/product/converter/use-subscription-sources-controller.ts - Advanced editor
packages/ui/src/product/converter/advanced-mode.tsx - Config store
packages/ui/src/store/config-store.ts - Template library
packages/ui/src/templates/template-library-surface.tsx - Product API adapter
packages/ui/src/product/api-adapter.tsx
Conversion engine
- Source parsers
packages/core/src/parser/index.ts - Config model
packages/core/src/types/config.ts - Mihomo generator
packages/core/src/generator/index.ts - Routing rules
packages/core/src/rules-database.ts - Template definitions
packages/core/src/templates/index.ts - YAML output
packages/core/src/generator/yaml.ts
Subscription services
- Subscription endpoints
local/app/api/subscriptions/route.ts - Subscription handlers
local/src/lib/subscription-route-handlers.ts - Subscription service
local/src/lib/subscription-service.ts - Source import API
local/app/api/source-import/route.ts - Import jobs
local/src/lib/source-import-jobs.ts - Automatic refresh
local/src/lib/auto-update-service.ts - Refresh scheduler
local/app/api/cron/update-subscriptions/route.ts - Template endpoints
local/app/api/templates/route.ts - Subscription data
local/src/lib/prisma.ts
Local platform
- Admin authentication
local/app/api/auth/login/route.ts - Admin and session data
local/src/lib/prisma.ts
Other components
- User
- Subscription sources
- Mihomo client
Connections 28
- User → Home workflow: configures
- Home workflow → Source controls: manages sources
- Source controls → Config store: updates sources
- Config store → Source parsers: parses inputs
- Subscription sources → Source parsers: provides content
- Source parsers → Config model: produces nodes
- Advanced editor → Config store: edits config
- Template library → Config store: applies templates
- Config store → Mihomo generator: generates config
- Routing rules → Mihomo generator: supplies rules
- Template definitions → Mihomo generator: supplies defaults
- Mihomo generator → YAML output: serializes config
- YAML output → Config store: updates preview
- User → Product API adapter: requests service
- Product API adapter → Subscription endpoints: calls endpoints
- Subscription endpoints → Subscription handlers: dispatches
- Subscription handlers → Subscription service: manages subscriptions
- Subscription service → Subscription data: reads and writes
- User → Source import API: starts import
- Source import API → Import jobs: starts or checks
- Import jobs → Subscription sources: fetches source
- Refresh scheduler → Automatic refresh: runs refresh
- Automatic refresh → Subscription data: updates subscriptions
- User → Template endpoints: manages templates
- Template endpoints → Admin and session data: checks admin
- User → Admin authentication: signs in
- Admin authentication → Admin and session data: verifies and records
- YAML output → Mihomo client: delivers configuration