zhiyanzhaijie/bestofrs

This release establishes the foundational architecture for a Rust-based application, introducing a modular crate structure with dedicated layers for domain, application, adapters, and UI. The UI layer is significantly expanded with a comprehensive Dioxus component library, including new views for repositories, tags, and admin panels, alongside robust i18n support for English and Chinese. Backend changes include a migration from SQLite to PostgreSQL for persistence, the introduction of server-side session management via Redis, and the implementation of OAuth2/SSO authentication. The release also delivers a complete admin interface for managing projects, tags, and backups, supported by a new centralized configuration system and dependency injection framework.

A new About page has been added to the UI, featuring localized content in English and Chinese via markdown files, along with SEO head metadata for the page. The component renders the appropriate language version based on the user's locale preference and includes custom styling for the about markdown content.

crates/ui/src/components/views/about · high confidence

A new CommonMarkdown component has been introduced in the UI library, enabling the rendering of Markdown content with support for custom link and image base URLs. The component handles relative URL resolution for both links and images, ensuring that all assets are correctly resolved against the provided base URLs. Additionally, a comprehensive set of CSS styles has been added to format headings, lists, blockquotes, code blocks, and other Markdown elements, with specific styling for both light and dark themes.

crates/ui/src/components/common/markdown · high confidence

The repository detail page now includes a dedicated section that fetches and renders the repository's README file. It displays the rendered Markdown content, handles cases where no README is present, and shows a loading skeleton while the content is being fetched.

_crates/ui/src/components/views/repo/detail/readme\section · high confidence

A new Backup component has been added to the admin panel, providing a user interface for managing database backups. Users can now create new backups with optional labels, view a list of existing backups (showing name, creation time, and size), and perform restore or delete actions on individual backup items.

crates/ui/src/components/views/admin/backup · high confidence

Introduced a new 'Finder' view in the admin interface that allows administrators to search for repositories using a fuzzy search API. The feature includes a control panel to set the search limit (up to 1000), and displays results in a sortable table. Users can sort the repository list by 'Created At' or 'Stars' in descending order. The view also implements pagination for the results, with a skeleton loader for initial states and error handling for failed requests.

crates/ui/src/components/views/admin/finder · high confidence

Introduces a new Tags management view in the admin panel, including a searchable table of tags with edit and delete actions, and an edit panel that supports base metadata editing and bulk group assignment to repositories. Also adds a Jobs view for running and monitoring daily snapshot ingestion, with a 'Run once' trigger and result display.

crates/ui/src/components/views/admin/tags · high confidence

A new 'GearMap' component has been added to the user layout, rendering a dynamic, animated arrangement of rotating gear icons. The component accepts parameters for the number of gears, a seed for deterministic placement, and styling options, creating a decorative background element that uses CSS animations for rotation.

crates/ui/src/components/layout/user/gearmap · high confidence

Users can now perform fuzzy searches across repositories and tags via a new search interface. This adds the frontend components for the fuzzy search feature, including a search input, result panels for repositories and tags, and associated skeleton loaders and fallback states.

_crates/ui/src/components/layout/user/fuzzy\search · high confidence

A new ranking panel has been added to the home page, allowing users to view and filter repositories by star, fork, issue, and recent metrics. The panel includes a tabbed interface for different ranking types, time range filters (daily, weekly, monthly), and a list of repositories with detailed stats and tags. This feature enhances the home page with interactive ranking data.

_crates/ui/src/components/views/home/rank\panel · high confidence

A new NotFound component has been introduced at crates/ui/src/components/views/not\_found/mod.rs, rendering a styled 404 page that displays the BORS Ferris icon and a title retrieved via the i18n translation function t("view\_not\_found\_title").

_crates/ui/src/components/views/not\found · high confidence

A new login view has been added to the UI component tree. When a user accesses this route, the component automatically redirects them to the GitHub authentication endpoint (/api/auth/login/github) using the Dioxus navigator. The view displays a 'Login' heading and a status message indicating that the user is being redirected to GitHub.

crates/ui/src/components/views/login · medium confidence

Users can now view a paginated list of tags, each displaying a rank, description, and top 10 associated repositories as interactive cards. The view includes a skeleton loading state, error handling, and i18n support for text.

_crates/ui/src/components/views/tag/tag\list · high confidence

The UI now supports English (en-US) and Chinese (zh-CN) locales. Users can switch between these languages to view the interface, including navigation, search, and content text, with English set as the default and fallback language.

crates/ui/src/impls/i18n · high confidence

New Dioxus context providers have been introduced to manage application-wide state. The \ConfigProvider\ exposes a \ConfigContext\ containing site configuration (e.g., \site\_url\) via the Dioxus context API. Additionally, a \PreferenceProvider\ manages user preferences using a reactive \Signal\<Preference\>\. These components allow child components to access global configuration and user preference data without explicit prop drilling.

crates/ui/src/components/providers · high confidence

The UI library introduces several new shared components: a breadcrumb navigation bar that dynamically generates links based on the current route, a pagination control for paginated lists, an IO cell wrapper for handling loading and error states, a reusable grid wrapper for background patterns, a typing text animation component, and an SEO head component for managing meta tags. These additions provide standardized building blocks for navigation, data presentation, and page metadata across the application.

crates/ui/src/components/common · high confidence

The admin interface now includes a dedicated project table component that supports fuzzy search, pagination, and filtering for disabled projects. Users can toggle between active and disabled project views, search by name or repository ID, and perform actions like editing or deleting projects directly from the table.

_crates/ui/src/components/views/admin/projects/project\table · high confidence

The admin projects page now includes a search bar that filters by repo\_id, name, slug, and description, along with a pagination component for the project table. An edit panel is also introduced, allowing users to add or edit projects via a side panel that opens when a project is selected or the add button is clicked.

crates/ui/src/components/views/admin/projects · high confidence

The project introduces a new \components\ module to organize shared UI building blocks for the Dioxus application. This includes modular exports for UI elements, layout, common components, providers, views, and icons, establishing the foundational structure for the application's user interface.

crates/ui/src/components · high confidence

The repository is initialized with essential project files, including an MIT license, a comprehensive README with architecture and contribution guides, and an AGENTS.md file providing Dioxus 0.7 development guidelines. Build and deployment are supported via a new Dockerfile and Dockerfile.worker, alongside a Docker Compose configuration for local development.

(repo-wide) · high confidence

The \crates/infra/src\ module has been initialized with a new \setup.rs\ file that defines the \AppContainer\ struct and the \init\_app\_container\ function. This change establishes the central state container that aggregates all domain-specific states (auth, backup, project, repo, snapshot) and their respective command/query handlers, effectively wiring up the application's dependency injection and runtime configuration loading.

crates/infra/src · high confidence

The application now supports a PostgreSQL backend for data persistence, replacing the previous SQLite implementation. This includes a new \PostgresBackend\ that connects to a PostgreSQL database, runs migrations from \migrations\_postgres/\, and provides repository implementations for projects, repositories, tags, and snapshots. The database schema has been updated to include new columns such as \avatar\_url\ and \homepage\_url\ on the \repos\ and \projects\ tables, and a \description\ column on \tags\. Additionally, the \UNTAG\ tag has been removed from the schema, and the \projects\ table's primary key has been changed to \repo\_id\.

crates/adapters · high confidence

The UI crate now exposes its public API through lib.rs, defining modules for components, root, IO, impls, and types. The main.rs entry point initializes logging, sets up the application container, configures session management via Redis, and starts the Axum server for full-stack rendering, while also supporting a client-side launch path for WebAssembly.

crates/ui/src · medium confidence

The \crates/app\ crate now provides a structured application layer with dedicated handlers and ports for authentication, backup, project, repository, and snapshot domains. This includes an \AuthCommandHandler\ for OAuth2/SSO flows, a \BackupCommandHandler\ for database backup/restore operations, and command/query handlers for projects, repositories, and snapshots. The change also introduces a centralized \AppError\ type for consistent error handling and common utilities like pagination and duration ranges.

crates/app · high confidence

The application now uses a structured configuration system that loads settings from environment variables and TOML files. This includes dedicated sections for the server, database, backup, Redis, authentication (specifically GitHub OAuth and session TTL), and web settings. Users can now configure these components via environment variables prefixed with APP\\ or by editing the provided example TOML file.

crates/infra/src/config · high confidence

A new 'Trend' tab has been added to the repository detail page, allowing users to analyze metric changes over time. This section includes a summary view showing daily, weekly, and monthly deltas for stars, forks, and issues, alongside interactive charts for both 'delta' (change over time) and 'snapshot' (absolute values) views, with support for weekly/monthly and monthly/yearly timeframes respectively.

_crates/ui/src/components/views/repo/detail/trend\section · high confidence

Users can now filter the repository list by time range (total, daily, weekly, monthly), sort by star/fork/issue/add time, and adjust the number of items per page (20, 50, or 100). The view also displays active tag filters and suggests additional tags to narrow results, with navigation updates reflecting these choices.

crates/ui/src/components/views/repo/list · high confidence

The application now renders a new root component that bootstraps the UI layer. This includes initializing internationalization (i18n), loading user preferences (theme, grid theme, and locale) from the server, and injecting the corresponding CSS and font assets. The component also sets the initial dark/light theme state via a bootstrap script, ensuring the correct theme is applied before the rest of the app renders.

crates/ui/src/root · medium confidence

Added the RepoList component, which fetches and displays a list of repositories with support for pagination, filtering, and sorting. The component manages the state for the repository list, including handling loading states with a skeleton UI and displaying error messages when necessary. It also integrates with the existing context to manage active tags, filter types, and sort types, ensuring a consistent user experience when browsing repositories.

_crates/ui/src/components/views/repo/list/repo\list · high confidence

The UI layer now exposes a comprehensive set of data transfer objects (DTOs) to serialize and deserialize domain entities for the frontend. This includes an authentication model (MeDto) for user sessions, a finder model (LatestPushedRepoDto) for displaying recently pushed repositories, and detailed DTOs for projects, repositories, tags, and search results. These types enable the UI to consume structured data for features like fuzzy search, project management, and repository browsing.

crates/ui/src/types · high confidence

The application now supports server-side session storage for authentication and user preferences. This adds the ability to store and retrieve user login state, OAuth pending states, and user preferences such as locale, theme, and grid theme via a Redis-backed session store. On the server, these sessions are initialized with configurable TTL and max lifetime, using secure cookie settings. On the client side, these session operations are no-ops or return defaults, ensuring the application can run without a backend session store. This change enables persistent user sessions and preference storage on the server, while maintaining client-side compatibility.

crates/ui/src/impls/session · high confidence

The application now exposes a comprehensive set of server-side API endpoints for user and admin operations. Authentication endpoints handle GitHub login, logout, and user status checks. User preference endpoints allow fetching and updating locale, theme, and grid theme settings. Admin endpoints provide backup management (list, create, delete, restore) and daily snapshot ingestion. Additionally, endpoints for listing, searching, and importing projects and repositories are introduced, alongside search functionality for repos and tags, and SEO-related endpoints for sitemap and robots.txt generation.

crates/ui/src/IO · high confidence

Added new CSS asset files to the UI layer: a global component theme file defining dark/light mode color variables and scrollbar styles, a font-face definitions file for 'iA Writer Mono S' and 'iA Writer Quattro S' typefaces, a Tailwind CSS placeholder, and a theme file establishing grid accent colors, background patterns, and shadow utilities.

crates/ui/assets · high confidence

Added five new JavaScript modules in crates/ui/src/js to handle specific UI interactions and state management. chart\_bridge.js manages chart lifecycle and upserts, dom\_bridge.js handles fuzzy search hotkeys and markdown link rewriting, scroll\_progress.js updates a scroll progress bar, scroll\_to\_top.js manages the 'scroll to top' button visibility and behavior, and theme\_bridge.js provides functions to detect and apply dark/light themes and language attributes.

crates/ui/src/js · high confidence

The UI library now includes a comprehensive set of new components, including AlertDialog, Avatar, Button, Dialog, DropdownMenu, HoverCard, Input, Pagination, Select, Separator, Sheet, and Tooltip. These components provide consistent styling, accessibility features, and interactive behaviors for common interface patterns. The implementation wraps underlying primitives with Dioxus-specific props and CSS classes, enabling developers to build complex interfaces with a unified design system.

crates/ui/src/components/ui · high confidence

Added new files in crates/ui/src/impls/ to provide concrete implementations for datetime formatting and parsing, HTTP error mapping, and server/client state types. The datetime module offers functions to parse and format UTC timestamps, the error module maps application errors to HTTP status codes, and the state module defines the server-side AppState type or a placeholder for client-side builds.

crates/ui/src/impls · high confidence

The application now uses three distinct layout components to structure the user interface. The \AdminLayout\ provides a sidebar-based navigation for administrative tasks, including project, tag, job, finder, and backup management. The \RootLayout\ serves as the base wrapper, integrating internationalization (i18n) and preference contexts. The \UserLayout\ defines the public-facing site structure, featuring a responsive header with mobile menu, fuzzy search, theme/language/color switchers, and a footer. These changes introduce new UI structures for different user roles and public access.

crates/ui/src/root/layouts · high confidence

The repository detail view now includes dedicated charting support. A new \chart.rs\ module provides functions to build configuration objects for line and bar charts (stars, forks, issues, watchers) and a \ChartJsCanvas\ component that loads Chart.js from a CDN and renders the visualizations. The \mod.rs\ file integrates these charts into the repo detail layout, wiring the chart configuration builders and canvas component alongside the existing meta, readme, and trend sections.

crates/ui/src/components/views/repo/detail · high confidence

The home page now features a dedicated layout with a hero section displaying the 'Best of Rust' title and subtitle, a FAQ section with three questions and answers, and an action section with buttons to 'Star on Github' and 'Recommend One'. The page also includes a rank panel and uses internationalization (i18n) for all text content, with custom CSS styles for hover effects on rank cards and a rotating rainbow background effect.

crates/ui/src/components/views/home · high confidence

The UI component library now includes new icon components for ArrowLeft, Plus, Search, Command, Eraser, X, Trash, and Wrench. These are implemented as Dioxus components that render SVG paths, allowing users to easily integrate these standard icons into their interfaces.

crates/ui/src/components/icons · high confidence

The repository detail page now features a dedicated meta section that displays the repository's avatar, name, description, and key metrics (stars, forks, issues). This new component includes built-in SEO head tags (title, description, keywords, canonical URL) and supports internationalization for all displayed text.

_crates/ui/src/components/views/repo/detail/meta\section · high confidence

The repository list view now uses a dedicated content component that renders a list of repository cards with pagination. Each card displays the repository's avatar, name, owner, description, and metrics (stars, forks, issues). The list supports scroll-to-anchor restoration for navigation state. Additionally, each tag on a card now shows a hover card with the tag's content.

_crates/ui/src/components/views/repo/list/repo\_list/repo\_list\content · high confidence

The application's navigation has been reorganized into a structured route tree, introducing dedicated views for the home page, user-facing pages (about, login, tag list, repo list/detail), and an admin section (projects, tags, job, backup, finder). This change establishes the URL structure and component wiring for these pages, including a 404 handler for unknown routes.

crates/ui/src/root/routes · high confidence

A new admin layout component has been introduced, featuring a sidebar with collapsible menu items, dropdown menus, and header/footer sections. The accompanying CSS defines styles for sidebar icons, info blocks, chevron animations, and responsive positioning for desktop views, enabling a structured navigation experience within the admin panel.

crates/ui/src/components/layout/admin · high confidence

A new TagContent component has been added to the common UI library, displaying a tag's label, description, and a list of top repositories. The component integrates internationalization (i18n) for all user-facing text, including the tag title, description, and repository list headers. It also includes a skeleton loader for the initial state and handles cases where the tag is not found.

_crates/ui/src/components/common/tag\content · medium confidence

Added a new tag listing view that includes a meta header with title, subtitle, and page size selector (10, 20, 50), a side tab menu for filtering by route tags, and SEO head metadata (title, description, keywords, canonical URL). The page displays a paginated list of tags with a cached fallback and supports context-based state management for page size, current page, and summary statistics.

crates/ui/src/components/views/tag · high confidence

Added new UI components for the user layout area, including a color switcher for grid themes, a theme switcher for dark/light mode, a language switcher for i18n, and a user profile dropdown with a logout action. Also added a footer with navigation links, a header navigation bar, and social links for Discord and GitHub.

crates/ui/src/components/layout/user · high confidence

The UI crate now exposes seven new view modules—about, admin, home, login, not\_found, repo, and tag—making these pages available for use in the application's navigation and routing structure.

crates/ui/src/components/views · high confidence

The crates/ui directory now includes Dioxus build configuration files (Dioxus.toml and Dioxus.toml.prod) that define the application title, component and asset directories, and WebAssembly optimization settings. Additionally, a Tailwind CSS entry point (tailwind.css) has been added to import the Tailwind framework and a custom theme file (assets/theme.css).

crates/ui · high confidence

The admin view components are now organized into separate modules for backup, repository finding, jobs, projects, and tags. This structural change improves code organization and maintainability within the admin interface.

crates/ui/src/components/views/admin · high confidence

The repository views are now organized into separate modules for the detail and list components, which are then re-exported from the parent module. This change improves code organization by splitting the repository view logic into dedicated files for the detail and list views.

crates/ui/src/components/views/repo · high confidence

The root layout component now includes two new UI features: a scroll progress bar that visually indicates page scroll position, and a floating button that allows users to quickly scroll back to the top of the page. These are implemented as new Dioxus components (ScrollProgress and ScrollToTop) that integrate with existing JavaScript modules for scroll behavior.

crates/ui/src/components/layout/root · high confidence

The admin project edit panel has been refactored to use a tabbed interface with two distinct sections: a 'Project' tab for editing project details (name, slug, description, status, tags) and a 'Repo' tab for managing repository tags. This change introduces new components for each tab, including loading skeletons and form handling logic, allowing administrators to manage project metadata and repository associations separately within the same panel.

_crates/ui/src/components/views/admin/projects/edit\panel · high confidence

The layout component directory now includes a mod.rs file that defines the public API for three layout sub-modules: admin, root, and user. This change re-exports all public items from the root and user modules, making them directly accessible via the layout module. This provides a centralized entry point for accessing these specific layout components within the UI crate.

crates/ui/src/components/layout · high confidence

The project introduces a Rust workspace with multiple crates (domain, app, adapters, infra, ui, worker) and their associated Cargo.toml and Cargo.lock files, establishing the foundational dependency graph for the application.

(dependencies) · high confidence

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

• CAI 46 → 45 (-1.3)
• Rubric changed (rubric-2026.08.18 → rubric-2026.09.15) — scores are not directly comparable.

• Code Health 45 → 43 (-2.0)
• Architecture 98 → 94 (-4.3)
• Maturity 67 → 67 (+0.5)
• Readiness 29 → 26 (-3.9)
• Security 71 → 88 (+16.9)
• Domain Modelling 100 → 100 (+0.0)
• Event-Driven 80 → 80 (+0.0)

• Change coupling: footer.rs ↔ header_nav.rs (crates/ui/src/components/layout/user/footer.rs)
• Change coupling: mod.rs ↔ mod.rs (crates/ui/src/components/views/repo/list/mod.rs)
• Change coupling: repo_repo.rs ↔ command.rs (crates/adapters/src/persistence/psql/repo_repo.rs)
• Dependency hygiene not measured — dependency manifest found but not parsed for hygiene
• High CVE: [GHSA redacted] (Cargo.lock)
• High vulnerability: [GHSA redacted] (Cargo.lock)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• LLM evaluation failed
• Medium CVE: RUSTSEC-2023-0071 (Cargo.lock)
• Medium advisory (unmaintained): RUSTSEC-2024-0320 (Cargo.lock)
• Medium advisory (unmaintained): RUSTSEC-2025-0141 (Cargo.lock)
• Medium advisory (unsound): RUSTSEC-2026-0097 (Cargo.lock)
• …and 8 more

• Ambiguous naming in RepoQueryHandler: 'search_by_key' and 'search_repo_page_by_key' likely perform the same search operation but return different structures or have different internal logic. The naming is confusingly similar. 'search_by_key' in ProjectQueryHandler is consistent with 'search_by_key' in RepoQueryHandler, but the existence of 'search_repo_page_by_key' in the same class suggests a split in responsibility that isn't clearly named.
• ClassTooLong: PostgresRepoRepo (crates/adapters/src/persistence/psql/repo_repo.rs)
• ClassTooLong: PostgresRepoTagRepo (crates/adapters/src/persistence/psql/repo_tag_repo.rs)
• Dependency hygiene PARTLY measured — Cargo dependencies read, dependency currency not (crates.io unreachable)
• Dependency source pinned to a moving git ref
• Documentation: no project overview (README.md)
• Duplicated block (10 lines × 2) (crates/app/src/project/command.rs)
• Duplicated block (10 lines × 2) (crates/ui/src/components/views/admin/projects/edit_panel/project_tab/mod.rs)
• Duplicated block (10 lines × 2) (crates/ui/src/components/views/admin/projects/project_table/mod.rs)
• Duplicated block (10 lines × 3) (crates/ui/src/IO/projects.rs)
• Duplicated block (10 lines × 3) (crates/ui/src/IO/repos.rs)
• Duplicated block (10–11 lines × 2) (crates/adapters/src/persistence/psql/repo_tag_repo.rs)
• Duplicated block (10–11 lines × 2) (crates/app/src/project/command.rs)
• Duplicated block (11 lines × 2) (crates/adapters/src/github.rs)
• Duplicated block (11 lines × 2) (crates/app/src/project/command.rs)
• Duplicated block (11 lines × 2) (crates/ui/src/components/views/admin/backup/mod.rs)
• Duplicated block (11 lines × 2) (crates/ui/src/components/views/admin/projects/edit_panel/mod.rs)
• Duplicated block (11 lines × 2) (crates/ui/src/components/views/admin/projects/project_table/mod.rs)
• Duplicated block (11 lines × 2) (crates/ui/src/components/views/admin/tags/edit_panel/group_tab/mod.rs)
• Duplicated block (11 lines × 2) (crates/ui/src/components/views/repo/detail/meta_section/mod.rs)
• …and 107 more

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

zhiyanzhaijie/bestofrs was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.