mirror of
https://github.com/RayLabsHQ/gitea-mirror.git
synced 2026-08-10 19:03:24 +02:00
ARUNAVO RAY
882e147504
* feat(ui): redesign dashboard and configuration screens New settings design language built from the design/giteamirror.pen file: cards with icon headers and status footers, header-level enable switches, toggle switches instead of checkboxes, uppercase section titles, selection tiles with icon chips and a check on the active option, segmented controls, and an indigo accent. Implemented via shared primitives in src/components/config/settings-ui.tsx and applied across: - Automation: header switches, schedule card, one-line auto-mirror copy with info tooltip, full-width Repository Cleanup card with Skip/Archive/ Delete tiles and dry run row - Notifications: segmented provider picker (ntfy/Apprise/Gotify/Webhook), events card with per-event switches - Connections: GitHub/Gitea connection cards with token creation guide and field helpers, Repository Selection and Mirror Content cards covering every mirror option, Organization Structure card with strategy tiles, destructive update protection tiles (BETA label removed) - Authentication: sign-in methods status card, identity providers restyle - Dashboard: flatter stat cards, icon panel headers, indigo view-all links All existing state handling, autosave and API behavior is unchanged. Light mode keeps working via theme tokens. README and website screenshots regenerated, docs references to renamed cards updated. * fix(ui): design polish pass from local review - Recent Activity rows get status icon circles (check, sync, sparkles, alert) - Connections tab restructured: connection cards share a stretched grid row so GitHub and Gitea stay equal height; Mirror Content moved to the right column; forms split into placeable cards via a part prop - Token guide panel: link moved to header as icon, larger text; redundant card footers removed (scopes line, test-connection hint) - Repository Selection gains a footer note; retention explanation moved below the selector - Authentication tab matches the design: side-by-side cards, row dividers, disabled state-reflecting switches with info hints, footers; SSO dialog restyled (segmented protocol tabs, field labels, indigo primary) - Import GitHub Data button is the indigo primary; disabled state is muted - Time format menu redesigned (locale pill, live examples, live clock in the trigger); theme switcher moved to sidebar as icon segmented control, system preference now persists correctly; legacy ModeToggle removed - Automation timezone pill no longer shows stored legacy UTC as a choice - Config tab bar wraps 2x2 on narrow screens instead of overflowing - README, website and PR screenshots regenerated
Gitea Mirror Documentation
This folder contains engineering and operations references for the open-source Gitea Mirror project. Each guide focuses on the parts of the system that still require bespoke explanation beyond the in-app help and the main README.md.
Available Guides
Core workflow
- DEVELOPMENT_WORKFLOW.md – Set up a local environment, run scripts, and understand the repo layout (app + marketing site).
- ENVIRONMENT_VARIABLES.md – Complete reference for every configuration flag supported by the app and Docker images.
- NIX_DEPLOYMENT.md – User-facing deployment guide for Nix and NixOS.
- NIX_DISTRIBUTION.md – Maintainer notes for packaging, releases, and distribution strategy.
Reliability & recovery
- GRACEFUL_SHUTDOWN.md – How signal handling, shutdown coordination, and job persistence work in v3.
- RECOVERY_IMPROVEMENTS.md – Deep dive into the startup recovery workflow and supporting scripts.
Authentication
- SSO-OIDC-SETUP.md – Configure OIDC/SSO providers through the admin UI.
- SSO_TESTING.md – Recipes for local and staging SSO testing (Google, Keycloak, mock providers).
If you are looking for customer-facing playbooks, see the MDX use cases under www/src/pages/use-cases/.
Quick start for local development
git clone https://github.com/RayLabsHQ/gitea-mirror.git
cd gitea-mirror
bun run setup # installs deps and seeds the SQLite DB
bun run dev # starts the Astro/Bun app on http://localhost:4321
The first user you create locally becomes the administrator. All other configuration—GitHub owners, Gitea targets, scheduling, cleanup—is done through the Configuration screen in the UI.
Contributing & support
- 🎯 Contribution guide: ../CONTRIBUTING.md
- 🐞 Issues & feature requests: https://github.com/RayLabsHQ/gitea-mirror/issues
- 💬 Discussions: https://github.com/RayLabsHQ/gitea-mirror/discussions
- 🔐 Security policy & advisories: https://github.com/RayLabsHQ/gitea-mirror/security