1.3.0

Frieren Release Notes - Version 1.3.0

This release centers on the module dependency installation flow — fully rebuilt on top of the unified BackgroundTaskHelper — plus a new shared loading component, an end-to-end test suite, and a round of backend hardening and developer-experience improvements.

New Features

• Reworked Module Dependency Installation: Dependency installs now run through the standard BackgroundTaskHelper instead of the legacy dependency-installer.sh flag/log scheme. The backend checks internet connectivity and rejects concurrent installs (BackgroundTaskHelper::isRunning), the frontend polls via the shared useBackgroundTask hook, streams live output into a collapsible log panel, and the "installing" module state is persisted (installingModuleAtom) so it survives navigation and reloads.

• Shared Loading Component: New Loading component renders the spinning loading image. The PNG asset is provided at runtime via window.Frieren.loadingImage (set by umdSupport) instead of being imported directly, so module UMD bundles no longer each inline a base64 copy of the image. Used in RouterProvider (auth bootstrap), SystemStatusModal (reboot/shutdown), and the dependencies alert.

• HTML Support in News: NewsCard now renders item.description as HTML, allowing links and formatting in dashboard news entries.

• End-to-End Test Suite: Added a full Playwright setup (playwright.config.js, global/mock setup) with three layers of specs — live API contract tests, mocked-API UI flows, and full UI specs — covering login, navigation, dashboard, hardware, modules, packages, settings, and wireless. Includes a recorded-responses fixture and a response recorder for offline mock runs.

Major Improvements

• Background Task Concurrency Guards: PackagesController now blocks updateLists while a module dependency install is in progress, and the dependency installer refuses to start when another install is already running — preventing opkg/apk clashes.

• Backend Refactor: Removed dead manual task-management code and the old modules/bin/dependency-installer.sh (101 lines); dependency installation now lives under packages/bin and streams output through BackgroundTaskHelper::start. installDependency takes a taskName and properly escapes each dependency via escapeshellarg. Controllers reference BackgroundTaskHelper by fully-qualified name instead of per-file use imports.

• UCI Getter Hardening: uciGet/uciGetJson calls across settings, wireless, and modules now pass the explicit "don't throw on missing key" flag and supply sensible defaults (terminal theme default, font size 13, cursor style block), so missing config no longer errors and validation lookups behave predictably.

• Package Manager --dest Support: package-manager-call.sh now understands --dest: ignored on apk (no per-destination install), forwarded as --dest <target> where supported — enabling SD-card dependency installs through the shared script.

• Module Deploy Support: tools/deploy.sh gained a module <name> <src-path> mode that builds a module with yarn and uploads it to the device, alongside the existing back/front/terminal targets.

UI/UX Improvements

• Dependencies alert shows a collapsible live log panel that auto-scrolls to the latest output, and auto-expands on install failure
• Reboot/shutdown modal and auth bootstrap screen use the new spinning Loading image instead of the Bootstrap spinner
• Available/installed module lists sorted by name via the new sortModulesByName helper

Bug Fixes

• Fix ErrorBoundary bug
• Fix setupUMDSupport bug (ReactContentLoader export shape)
• QA fixes across modules and dependency flow

Developer Experience

• Playwright e2e harness with API-contract, mocked-UI, and full-UI test layers plus a response recorder for regenerating mocks
• tools/deploy.sh module target for one-command module build + deploy
• sortModulesByName extracted to a reusable helper
• installingModuleAtom (persisted) replaces the old dependencyInstallStatusAtom / useGetDependencyInstallationStatus hook
• BackgroundTaskHelper::isRunning helper for in-progress task detection
• Module template version bump

Full Changelog: 1.2.0...1.3.0

1.2.0

Frieren Release Notes - Version 1.2.0

This release focuses on polish, reliability, and developer experience — with skeleton loaders across the entire UI, comprehensive toast feedback, cache busting for builds and modules, backend security hardening, and major frontend/backend refactors to standardize patterns.

New Features

• System Update from Dashboard: Download, install, and reboot directly from the dashboard when an update URL is present in news.json.
  Backend runs the update script in the background with status polling. Frontend shows an update button in the UpdateAlert component with a
  confirmation dialog before proceeding.

• Skeleton Loaders: Integrated react-content-loader across the entire webapp — wireless, dashboard, settings, and all data-dependent
  views now display skeleton placeholders while loading.

• Search in Logs: New reusable SearchInput component with clear button, applied to SystemLogsCard for filtering log entries.

• Wireless Interface Status Feedback: Backend polls wpa_supplicant for STA connection state and network.wireless for AP/monitor status.
  Frontend polls after save and shows success/failure toast with automatic overview refresh.

• Internet Connectivity Check: Network-dependent operations now verify internet connectivity before proceeding.

• Package Autoremove: Added autoremove flag support to the package manager.

Major Improvements

• Backend Refactor: Moved script paths and BackgroundTaskHelper calls from Helpers to Controllers (dashboard, packages) following the
  Hardware pattern. Added escapeshellcmd as default to OpenWrtHelper::exec with a raw flag bypass for commands with pipes/redirects.
  Removed dead code and duplicate constants.

• Frontend Refactor: Renamed hooks and atoms for clarity (useRouterRules → useHashLocation, selectedRemoteModuleAtom →
  installModuleAtom). Extracted validation schemas and wireless constants to dedicated helper files. Standardized polling interval to 2000ms
  across all useBackgroundTask consumers.

• Background Task Standardization: New BackgroundTaskHelper on the backend and shared useBackgroundTask hook on the frontend. All
  polling patterns now go through a single, consistent implementation with a 1-hour default timeout to prevent infinite polling.

• Toast Feedback Everywhere: Added success/error toast notifications to all settings mutations (hostname, timezone, theme, terminal,
  datetime, password) and wireless mutations (toggle, radio config, interface removal). Fixed misleading system action messages on
  shutdown/reboot.

• Cache Busting: Vite build plugin appends timestamp query parameters to JS/CSS assets. UMD module loading now uses version-based cache
  busting to ensure fresh module loads.

• Shell Script Hardening: Added error handling to shell scripts, fixed SSH host key verification and SCP protocol issues.

UI/UX Improvements

• About page replaced with a modal in the system actions dropdown
• Enhanced reset/shutdown UX flow
• Sidebar CSS transitions refactored for cleaner expand animation
• Interface status spinner moved from card title to RadioSection row with a "checking" label
• Install modal now locks during module installation to prevent accidental closure
• Bold package name and line break in removal confirmation dialog
• ConfirmationModal supports loading state with spinner, disabled buttons, and locked backdrop
• Buttons auto-generate aria-label from label or icon name for accessibility
• SearchInput clear button is keyboard accessible (tab + enter/space)
• ErrorFallback now includes a Try Again button
• Empty state messages for UsbDevicesCard and FileSystemUsageCard
• Password form clears fields after successful change
• Dark theme detector logic exported for reuse

Bug Fixes

• Fix double escaping in exec calls that use escapeshellarg internally
• Fix form provider reload bug
• Fix useShutDownMutation internal export name
• Fix double-encoded HTML entity in ErrorFallback
• Fix api-test.sh unbound variable with set -u
• Fix misleading "Logoff user" message on shutdown/reboot actions
• Multiple QA fixes

Developer Experience

• BackgroundTaskHelper provides a standard backend pattern for background task polling
• Validation schemas extracted to reusable helper files
• Wireless constants (MODE_OPTIONS, NETWORK_OPTIONS, ENCRYPTION_OPTIONS) centralized
• WPA passphrase max 63 character validation added
• Cryptic single-letter variables renamed to descriptive names in wireless feature
• index.php added to backend deploy script

Full Changelog: 1.1.0...1.2.0

1.1.0

Frieren Release Notes - Version 1.1.0

This release represents a major evolution of Frieren, with extensive rewrites across the wireless module, terminal system, and module template tooling — alongside entirely new features like the package manager and news feed.

New Features

• Packages Manager: Full opkg package management interface. Browse available packages, search, install, and remove packages directly from the web UI. Background task execution for non-blocking installs with real-time status feedback.

• News Feed: Dashboard now displays project news and update alerts, keeping users informed about new releases and announcements.

• Terminal Autologin: New setting in Settings module to enable automatic terminal login, removing the need to authenticate each session.

• Terminal Theme Support: The embedded terminal now supports multiple color themes, configurable from the UI.

Major Improvements

• Wireless Module Rewrite: Completely rebuilt wireless management. New radio configuration modal, interface form editor with mode-aware fields, wireless scanning modal, association list view, wireless overview with per-radio sections, advanced configuration card, and raw wireless config editing. Full CRUD for wireless interfaces — add, configure, toggle, and remove.

• Terminal Rewrite: The frieren-terminal subproject was rewritten. New core architecture with xterm.js integration, resize bug fixes, additional options support, and a proper build pipeline that produces inline HTML for ttyd.

• Module Template Overhaul: New CLI tools for module development — wizard (scaffolding), validate (module checks), update-module (sync dependencies with template), and version-bump (bump version in package.json + manifest.json). Updated Vite config with UMD build, external deps mapping, and compression support.

• UI/UX Refresh: Revised CSS rules across the framework. Updated general layout and settings layout for improved usability. Toast notifications now follow the active theme. High-resolution favicon.

Bug Fixes & Quality

• Multiple QA passes on wireless and packages features
• Module dependency installation fixes
• Backend refactoring and API core improvements
• SQLite helper updates

Developer Experience

• New api-test.sh — CLI tool for testing backend APIs via curl with session management
• New deploy.sh — SCP-based deployment for backend and frontend to device
• New ssh-cmd.sh — Run commands on device via SSH
• Configurable VITE_DEV_PROXY_TARGET for frontend dev proxy
• License updated

Dependencies

• Frontend dependencies upgraded across the board
• Module template pinned to Yarn 4.14.1, Node >=22, Vite 7

Full Changelog: 1.0.0...1.1.0

1.0.0

Frieren Release Notes - Version 1.0.0

We're thrilled to unveil Frieren 1.0.0, the inaugural version of our micro-framework tailored for security gadgets. This release brings forward a collection of features optimized for empowering users to manage routers and Single Board Computers (SBCs) with enhanced efficiency and insight. Let’s dive into what’s new:

Features at a Glance:

• Dashboard: Presenting a snapshot of your system’s health with live data on system load and memory utilization to gauge the current operational state.

• Hardware: A diagnostic hub presenting system logs, a list of connected USB devices (lsusb), and disk space usage (df). It includes a diagnostic tool to generate system reports.

• Login: A robust authentication mechanism to protect the management interface from unauthorized access with reinforced security protocols.

• Modules: An adaptable module framework that enables straightforward installation and management of specialized features to cater to diverse security operations.

• Settings: Streamline your device’s operations with customizable settings for network identification, interface theming, time synchronization, and secure access controls. Adjust your hostname, select dashboard themes, sync time directly from your browser, configure time zones, and update user credentials effortlessly.

• Terminal: An embedded terminal emulator that offers direct access to command-line interface (CLI) for advanced device configuration and management tasks.

• Wireless: A full-fledged toolkit for wireless management, equipped to handle network scanning, connectivity settings, and encryption standards setup for secure wireless operations.

This first release is the result of a concerted effort to ensure each feature not only integrates seamlessly but also performs optimally under various conditions. Your exploration and feedback are invaluable for the continuous enhancement of Frieren.