mirror of
https://github.com/0x2E/fusion.git
synced 2026-05-19 18:30:35 +00:00
Yuan
ad25dde50f
* init refactor plan * remove old files * api design * implement store layer * implement api * Add comments for store package * init frontend * implement pull service * use slog * two column layout * new design * fix env var * fix * stabilize store tests and query ordering * remove settings.local.json and update .gitignore to exclude .claude * improve layout and styling in sidebar and settings dialog * add group management modal * add feed management * add OPML import and export * use favicon * fix article list * fix * fix ui * search debounce * fix ui * store states in url * fix: resolve nested button hydration error in ArticleItem * edit feed * filter items by group * fix ui * fade unread count * add confirmation dialog for feed deletion and bold key names in confirmations * fix search * add optional OIDC authentication support Allow self-hosted users to integrate with SSO providers (Authelia, Keycloak, etc.) via OIDC. Enabled by setting FUSION_OIDC_ISSUER and related env vars. Uses PKCE S256 for security. When disabled, behavior is unchanged — login page shows password only. * add article content processing with link, image, and tracking pixel handling * replace goreleaser with shell script for cross-platform builds Remove .goreleaser.yaml and add a `release` command to scripts.sh that builds 6 platform combos (linux/darwin/windows × amd64/arm64), creates zip archives with LICENSE/README, and generates sha256 checksums. Update release workflow to use scripts.sh + gh CLI instead of goreleaser-action. All build paths updated for backend/ subdirectory. * implement feed discovery with feedfinder and feed selection Replace placeholder feed validation with real RSS/Atom discovery so users can pick the correct feed URL before subscribing. * standardize icon button sizes and improve responsive layout * auto-fill empty site_url and keep OPML htmlUrl metadata * add feed management page * fix about panel * responsive optimization * fix search dialog result display and article drawer blank issue - Add unique value props to CommandItems to prevent cmdk deduplication - Use getFeedById from store instead of searching within search results - Fetch article from API when not found in store (e.g. opened from search) * improve AGENTS.md * use tanstack-query * harden auth config and optimize feed pulling * optimize frontend route loading and lint compliance Split heavy pages into lazy-loaded route modules to reduce initial bundle size and keep startup responsive. Also fix lint blockers in search/login flows and align ESLint rules with shadcn ui exports. * harden feed networking and improve store query performance * expand backend tests and unify test helpers * fix unstable fallback GUID generation for feed items * update docs * simplify command responses with 204 and 202 statuses * enforce foreign keys in initial sqlite schema * use upstream static icons for frontend branding * refactor ci * add gray fallback for missing feed favicons * highlight AI-free value in README * enhance frontend PWA install and update flow Expose browser install prompts in settings and add service worker update handoff so users can install Fusion and apply new versions without manual cache clearing. * add robust legacy sqlite migration path Automatically detect pre-migration schemas and rebuild them into the current schema so upgrades preserve user data safely and idempotently. * embed frontend build artifacts into backend binary * fix login flow for empty-password setups * fix gin server mode to release * fix * add visibility logs for database migrations * fix starred button background in dark mode * align gin HTTP logging with slog output * optimize user guidance * refactor reader routes to path-based state * update screenshots
1.4 KiB
1.4 KiB
Contributing to Fusion
Thanks for contributing.
Fusion values simple, maintainable changes over complex abstractions.
1. Before you start
- Search existing issues/PRs first.
- For bugs, include reproducible steps, expected behavior, and actual behavior.
- For features, explain the concrete use case and user value.
2. Local setup
Requirements:
- Go
1.25+ - Node.js
24+ - pnpm
Install dependencies:
# frontend
cd frontend && pnpm install
Backend uses Go modules and installs dependencies automatically via go tooling.
3. Validation checklist (required before PR)
Backend
cd backend
go test ./...
goimports -w .
go build -o /dev/null ./cmd/fusion
Frontend
cd frontend
npx tsc -b --noEmit
pnpm lint
pnpm build
If your change is scoped, you can run a smaller test subset first, but run the relevant final checks before requesting review.
4. Pull request expectations
- Keep PRs focused. One PR should solve one clear problem.
- Explain why the change is needed, not only what changed.
- Include screenshots/GIFs for UI changes.
- Link related issue(s).
- Mark as Draft if not ready for review.
- If you use AI tools, review and validate outputs carefully before submission.
5. Code style guidelines
- Prefer readable, self-explanatory naming.
- Avoid over-engineering.
- Add comments only for non-obvious logic or decisions.
- Keep docs and API behavior aligned when changing contracts.