Clash Nyanpasu v2.0.0-beta.1

Clash Nyanpasu 2.0 is a major release featuring a substantially redesigned application architecture, a new Material You–inspired interface, a rewritten profile/runtime pipeline, improved traffic analytics, and extensive performance and reliability work.

This is the first beta release of the 2.0 series. Some regressions and incomplete features may still exist.

Highlights

Completely redesigned interface

Clash Nyanpasu 2.0 introduces a redesigned Material You–inspired interface and a new frontend architecture.

• Rebuilt the main application layout and experimental UI structure — by @keiko233
• Added the new Dashboard with configurable widgets — by @keiko233, @greenhat616
• Added daily dashboard widgets and expanded the widget library — by @keiko233 in #5566
• Added the new Profiles page — by @keiko233 in #3987
• Added the new Providers page — by @keiko233 in #4329
• Added the new Proxies page and proxy-management components — by @keiko233
• Added the new Rules page with virtualized rendering — by @keiko233 in #4044
• Added the new Connections page — by @keiko233, @greenhat616
• Rebuilt topology into the new Traffic Analytics page — by @greenhat616 in #5519
• Redesigned Settings — by @keiko233
• Added a redesigned Logs viewer — by @keiko233, @greenhat616
• Added responsive Sidebar and mobile navigation variants — by @keiko233
• Added platform-specific headers for Windows/macOS/Linux — by @keiko233
• Added directional route animations and shared AnimatedOutlet components — by @keiko233
• Added system accent-color integration — by @keiko233 in #4632
• Added an HCT theme color picker with live preview — by @greenhat616 in #5561
• Added Material Design color variables and new theme infrastructure — by @keiko233
• Added configurable window decorations — by @keiko233
• Added multi-window support — by @keiko233 in #4030
• Added a new animated logo and loading states — by @keiko233

The legacy UI has been removed as part of the 2.0 transition — by @keiko233 in #4508.

Traffic Analytics

The previous topology view has evolved into a substantially more complete traffic analytics system.

• Added profile-scoped traffic accounting backed by redb — by @greenhat616 in #5477
• Added application-level session traffic recording — by @greenhat616 in #5478
• Exposed session traffic through the client facade — by @greenhat616 in #5479
• Added time-bucketed traffic history with retention — by @greenhat616 in #5518
• Rebuilt the topology page as Traffic Analytics — by @greenhat616 in #5519
• Added geographic traffic visualization — by @greenhat616 in #5552
• Added ranking views weighted by traffic or connection count — by @greenhat616 in #5557
• Added animated ranking-list reordering — by @greenhat616 in #5555
• Added region lookup using Nyanpasu's own country index — by @greenhat616 in #5550
• Added DIRECT peer location tracking — by @greenhat616 in #5551
• Added public-address probing for DIRECT traffic — by @greenhat616 in #5547
• Added opt-in public IP probes for locating local traffic sources — by @greenhat616 in #5580
• Added closed connections and live IDs to traffic filters — by @greenhat616 in #5562
• Added navigation between Rules, Connections and Traffic — by @greenhat616 in #5565
• Added navigation history so users can return after jumping between analysis pages — by @greenhat616 in #5563
• Added development traffic-preview data — by @greenhat616 in #5553

Profiles and runtime pipeline

The profile system has been substantially redesigned around a new typed domain model and runtime pipeline.

• Added a new profile domain model and clean composition model — by @greenhat616 in #4840
• Redesigned runtime snapshots around the new profile model — by @greenhat616 in #4868
• Added the pure runtime pipeline executor — by @greenhat616 in #4877
• Added RuntimeBuilder and snapshot baselines — by @greenhat616 in #4888
• Migrated profiles to the new domain pipeline across composition root, IPC and frontend — by @greenhat616 in #4889
• Added the profile domain layer, file service, actor and refresh scheduler — by @greenhat616 in #4910
• Added schema revisions to profiles.yaml — by @greenhat616 in #5364
• Added profile revision 3 migration — by @greenhat616 in #4899
• Added configuration backups before migration and from Settings — by @greenhat616 in #5529
• Added profile-processing chains — by @keiko233, @greenhat616
• Added drag-and-drop profile sorting — by @keiko233
• Added chain reordering and migration support — by @greenhat616
• Added profile context menus — by @keiko233
• Added global subscription update — by @greenhat616
• Added local profile update support — by @Slinetrac in #3674
• Added runtime snapshots to Profile Inspect — by @greenhat616 in #5222
• Added automatic Profile Inspect refresh and step logs — by @greenhat616 in #5417
• Added process-chain visualization and profile names in Profile Inspect — by @greenhat616 in #5421
• Added diff YAML highlighting and tabbed step logs — by @greenhat616 in #5422
• Added transform diagnostics and profile-name reporting — by @greenhat616 in #5466
• Added profile sync status and persisted run history — by @greenhat616 in #5459
• Reflected the config/transform hierarchy directly on the Profiles page — by @greenhat616 in #5416
• Added Remnawave subscription HWID integration — by @kolya13245 in #4361
• Added subscription profile-name synchronization from remote headers — by @kolya13245
• Added hidden proxy-group support from subscription metadata — by @kolya13245 in #3434
• Added support for IP hosts in subscription URLs — by @keiko233

Core architecture

The backend core-management layer has been substantially rewritten.

• Added CoreActor v2, ServiceActor and DNS wiring — by @greenhat616 in #5116
• Moved the core lifecycle onto CoreControl — by @greenhat616 in #5182
• Added serialized lifecycle operations through actors — by @greenhat616 in #5201
• Added revocable, instance-bound Clash API access — by @greenhat616 in #5203
• Routed rule operations through the bound Clash API — by @greenhat616 in #5204
• Routed rule-provider reads through the bound Clash API — by @greenhat616 in #5206
• Routed config reads through the bound Clash API — by @greenhat616 in #5208
• Moved proxy callers into an injected actor — by @greenhat616 in #5215
• Serialized configuration writes through the core facade — by @greenhat616 in #5217
• Bound proxy-mode interruption to the lifecycle workflow — by @greenhat616 in #5219
• Added profile and proxy interruption policies — by @greenhat616 in #5250
• Added startup reconciliation and ordered shutdown — by @greenhat616 in #5387
• Added graceful fallback to local core execution when service mode is unavailable — by @greenhat616 in #5528
• Added disconnected service-endpoint recovery — by @greenhat616 in #5248
• Added native-state preservation across desktop and service modes — by @4o3F in #5425
• Added Windows named-pipe service control — by @greenhat616 in #5282
• Added named-pipe IPC retry handling — by @greenhat616 in #5281

Core support

• Added meow-rs core support — by @xmh0511 in #4987
• Improved clash-rs alpha support — by @greenhat616, @keiko233
• Added Windows ARM64 support for clash-rs alpha — by @greenhat616
• Updated clash-rs alpha binary names and download URL handling — by @keiko233
• Updated clash-rs upstream references — by @greenhat616 in #5357
• Updated Mihomo AMD64 variants to v2 — by @3gf8jv4dv in #4914
• Added support for additional sidecar architectures — by @greenhat616
• Added a new core manager UI — by @keiko233 in #4140
• Moved core updates into an injected actor — by @greenhat616 in #5249

Connections

The Connections page has been rebuilt with a larger feature set.

• Added the new Connections page — by @keiko233
• Added connection detail dialog — by @greenhat616
• Added connection totals — by @greenhat616
• Added column filtering — by @greenhat616
• Added closed-connections tab and configurable columns — by @greenhat616 in #5486
• Added traffic-dimension and range filters — by @greenhat616 in #5564
• Added delete-connections support — by @keiko233
• Improved numeric sorting and table ordering — by @greenhat616
• Improved table header rendering — by @greenhat616
• Added localized connection table and detail fields — by @greenhat616
• Fixed sticky-header scrollbar positioning — by @greenhat616 in #5509

Rules

• Added the new Rules page — by @keiko233
• Added virtualized rule rendering — by @keiko233 in #4044
• Added proxy filtering — by @keiko233
• Added Clash rules/provider query hooks — by @keiko233
• Added live connections and traffic per rule — by @greenhat616 in #5487
• Added navigation from Rules into Connections and Traffic — by @greenhat616 in #5565

Proxies

• Added the new proxy-management route and UI — by @keiko233
• Added proxy-group delay testing — by @keiko233
• Added connection speeds to group headers — by @keiko233
• Added recent latency history to proxy-node cards — by @greenhat616 in #5247
• Added proxy-group type and selected-node latency display — by @greenhat616 in #5302
• Added no-proxies-found handling — by @keiko233
• Added normalized proxy transport where nodes are sent once and referenced by name — by @greenhat616 in #5430
• Fixed provider-owned proxy resolution — by @Jimie165 in #4954
• Added hidden node-attribute support — by @MNDIA in #1819
• Improved proxy-chain UI — by @Slinetrac in #3663

Logging

The logging subsystem has been redesigned from storage through presentation.

• Added a new Nyanpasu log indexer — by @greenhat616
• Exposed application and service logs through the client facade — by @greenhat616 in #5254
• Added application/service files to the log viewer — by @greenhat616 in #5255
• Unified the log viewer with the new Material You UI — by @greenhat616 in #5258
• Added scroll-based history loading — by @greenhat616 in #5259
• Added JSON highlighting and improved live-follow behavior — by @greenhat616 in #5260
• Added Material You date filters — by @greenhat616 in #5261
• Added automatic log rotation by file size and local day — by @greenhat616 in #5409
• Added virtualized log rendering — by @keiko233
• Added log search with highlighted matches — by @keiko233
• Added clear-log actions — by @keiko233
• Added Debug log capture and persisted session history — by @4o3F in #5490
• Added configurable log-file settings — by @keiko233
• Added log-level selector — by @keiko233

Scripting and configuration transforms

• Added JSON and raw-text module imports for JavaScript scripts — by @greenhat616
• Added embedded JavaScript modules and helper tools — by @greenhat616 in #3639
• Added improved HTTP module loading — by @greenhat616
• Upgraded Boa and preserved nested YAML templates — by @greenhat616 in #5202
• Added in-memory JavaScript transforms with preserved stack traces — by @greenhat616 in #5450
• Added Boa console integration and log sinks — by @greenhat616 in #5449
• Added Lua console output matching JavaScript — by @greenhat616 in #5455
• Preserved mapping key order through Lua transformations — by @greenhat616 in #5454
• Improved JavaScript wrapping/export handling — by @greenhat616 in #5452
• Added LESS support to the custom CSS editor/compiler — by @keiko233
• Added CSS worker support and improved completion — by @keiko233
• Added custom CSS specification groundwork — by @keiko233 in #4574

System proxy and networking

• Added PAC proxy support with download, validation and fallback — by @Slinetrac in #3724
• Added new system proxy hooks — by @keiko233
• Added configurable Mixed / SOCKS5 / HTTP port strategies — by @greenhat616 in #5400
• Added mixed-port configuration UI and random-port options — by @keiko233
• Added DNS cache management — by @keiko233
• Added external-controller configuration UI — by @keiko233
• Added TUN permission warnings and automatic permission handling on Unix — by @greenhat616
• Reset empty system-proxy bypass values to defaults — by @Slinetrac in #3597
• Added typed ownership for proxy, PAC and auto-launch state — by @greenhat616 in #5268

Tray

• Added configurable tray-menu close behavior — by @keiko233
• Added OS-specific default tray-menu behavior — by @keiko233
• Added new tray-settings UI and tray-icon configuration — by @keiko233
• Added traffic display in the tray — by @Slinetrac in #3653
• Added macOS colored tray icons — by @Slinetrac in #3653
• Added optional tray text — by @Slinetrac in #3648
• Fixed multiple checked proxies in the tray menu — by @Slinetrac in #3624
• Added groundwork for a web-based tray menu — by @keiko233 in #4527

Updater

• Added a redesigned updater UI — by @keiko233 in #4091
• Added persistent release channels with UI switching — by @greenhat616 in #5332
• Added Beta prerelease publishing and fixed Beta update paths — by @greenhat616 in #5532
• Added Windows Nightly updater support — by @greenhat616
• Added Nightly release-link handling — by @keiko233
• Added ordered package download sources — by @keiko233
• Added ghfast as a download source — by @keiko233
• Added update notification buttons and localization — by @keiko233
• Added application update hooks and tests — by @keiko233 in #5579
• Added safer shutdown before launching the update installer — by @greenhat616 in #5543
• Added Nightly signing using the release version — by @greenhat616 in #5464
• Added support for additional updater targets — by @greenhat616

Internationalization

• Migrated frontend localization to @inlang/paraglide-js — by @keiko233
• Added automatic UI language selection from system locale — by @greenhat616 in #5228
• Added Korean translation — by @moduvoice in #4923
• Added Traditional Chinese support — by @3gf8jv4dv in #2431
• Added Traditional Chinese NSIS installer localization — by @3gf8jv4dv in #2517
• Added translated time units and dialog buttons — by @3gf8jv4dv in #2530
• Added localized connection table/detail fields — by @greenhat616
• Synced Day.js locale with selected language before its later frontend replacement — by @keiko233
• Performed extensive Simplified Chinese, Traditional Chinese and English translation refinement — by @3gf8jv4dv
• Updated Russian localization — by @legiz-ru in #2170

Performance

Performance was a major focus during the final stages of the 2.0 beta.

• Reduced connection-sample rendering cost — by @greenhat616 in #5496
• Prevented settings/system/WebSocket hooks from causing unnecessary re-renders — by @greenhat616 in #5495
• Stabilized profile/provider data across refetches — by @greenhat616 in #5494
• Reduced Rules page rendering cost — by @greenhat616 in #5497
• Lazy-loaded Shiki and cached core-version reads — by @greenhat616 in #5498
• Prevented sample/KV updates from rerendering entire Dashboard widgets — by @greenhat616 in #5499
• Moved marquee animation onto compositor-friendly paths — by @greenhat616 in #5500
• Moved logo idle animation onto compositor-friendly paths — by @greenhat616 in #5501
• Limited modal layout measurement to open/close transitions — by @greenhat616 in #5502
• Limited tab-indicator measurement to movement — by @greenhat616 in #5503
• Moved sparkline scrolling onto the compositor — by @greenhat616 in #5504
• Incrementally rendered very large Profile Inspect diffs — by @greenhat616 in #5505
• Derived theme state from color changes instead of every render — by @greenhat616 in #5506
• Deferred rendering of lower Settings sections — by @greenhat616 in #5508
• Reduced Logs page rendering cost — by @greenhat616 in #5510
• Cached highlighted YAML and skipped highlighting for very large documents — by @greenhat616 in #5511
• Limited profile-card gradient animation to hover — by @greenhat616 in #5512
• Reduced log-row mounting cost and skipped unchanged rows — by @greenhat616 in #5513
• Reduced frame drops while switching proxy groups — by @greenhat616 in #5445
• Split WebSocket history contexts by data type — by @greenhat616 in #5413
• Sent connection details only to subscribed pages — by @greenhat616 in #5429
• Avoided WebKit slow paths in Tailwind space/divide selectors — by @greenhat616 in #5448
• Reduced shell rerenders during scroll, resize and proxy updates — by @greenhat616 in #5492
• Reduced jank during route transitions and connection/proxy updates — by @greenhat616 in #5423
• Kept Monaco out of the main application bundle — by @greenhat616 in #5493

State, configuration and IPC

2.0 substantially changes how Nyanpasu stores and applies configuration.

• Added typed configuration actor infrastructure — by @4o3F
• Wired typed config actors into application setup — by @4o3F
• Migrated typed configuration state actors — by @greenhat616 in #4869
• Routed legacy reads and writes through typed actors — by @4o3F
• Removed the legacy global Config state — by @greenhat616 in #5386
• Migrated configuration IPC to typed app/clash configuration — by @greenhat616 in #5385
• Added selective TCC-based source mutation convergence — by @greenhat616 in #5367
• Added UI visibility for convergence and unconfirmed operations — by @greenhat616 in #5368
• Added typed config/storage errors — by @greenhat616 in #5435
• Added typed runtime/core errors — by @greenhat616 in #5433
• Added typed profile errors with context — by @greenhat616 in #5432
• Added typed subscriber acknowledgements and degradation reasons — by @greenhat616 in #5434
• Added typed application effect planning/status — by @greenhat616 in #5266
• Added effect reconciliation after typed config commits — by @greenhat616 in #5267
• Added cross-transport RPC — by @keiko233 in #5484
• Migrated frontend hooks to tauri-specta-query — by @keiko233

Migration and recovery

• Rewrote the migration subsystem around PathResolver — by @greenhat616 in #4824
• Added centralized PathResolver — by @greenhat616 in #4828
• Preserved typed Clash configuration through migration — by @4o3F in #4880
• Added revision-based profile migrations — by @greenhat616
• Added configuration backups before migrations — by @greenhat616 in #5529
• Added migration-state consistency checks — by @greenhat616 in #5359
• Added migration log opening when migration fails — by @greenhat616
• Added dangling profile-transform reconciliation — by @4o3F
• Added v2 migration enablement and chain migration — by @greenhat616

Reliability fixes

This release also includes a large set of stability fixes.

• Fixed Windows service-mode issues — by @4o3F
• Fixed service install/uninstall/control error handling — by @keiko233
• Fixed races in core execution with run_lock — by @keiko233
• Fixed lifecycle shutdown when workflows terminate unexpectedly — by @greenhat616 in #5540
• Fixed application shutdown when the main thread panics — by @greenhat616 in #5542
• Fixed internal HTTP server shutdown — by @greenhat616 in #5541
• Fixed profile files crashing the application when opened — by @greenhat616 in #5524
• Fixed failed connection drops incorrectly failing profile activation — by @greenhat616
• Fixed profile-chain drag state synchronization — by @greenhat616 in #5277
• Fixed system proxy bypass handling — by @4o3F
• Fixed dashboard freezing while hidden — by @Slinetrac in #3654
• Fixed allow-lan runtime persistence — by @yokinanya in #4718
• Fixed LAN setting persistence and recovery — by @Slinetrac in #3633
• Fixed proxy-provider ownership resolution — by @Jimie165 in #4954
• Fixed startup panics before the tray is initialized — by @keiko233
• Fixed Windows singleton isolation across users/configurations — by @Slinetrac in #3622
• Fixed Linux window management — by @Slinetrac in #3676
• Fixed window movement across monitors with different scaling — by @Slinetrac in #3675
• Fixed minimized-window state preservation — by @Jimie165 in #4943
• Fixed macOS DNS handling while toggling TUN — by @greenhat616
• Fixed several macOS window resize, traffic-light and service issues — by @greenhat616
• Fixed cross-version NSIS upgrades to default to in-place updates — by @greenhat616 in #4807
• Fixed updater executables replacing NSIS installers — by @4o3F in #5420
• Fixed log-level configuration that could crash the application — by @greenhat616 in #5533
• Fixed log history loading and toolbar layout — by @greenhat616
• Fixed stale route rendering during animated navigation — by @keiko233
• Fixed navbar highlighting across subpages — by @greenhat616 in #5441
• Fixed sidebar width instability across routes — by @greenhat616 in #5419
• Fixed dashboard sparkline jitter — by @greenhat616 in #5412
• Fixed outlined input/select rendering issues — by @greenhat616
• Fixed memory and subscription-usage display — by @Bihrys in #4436
• Fixed saved proxy-mode preference when restarting the core — by @temp-maker-temp in #3919
• Fixed Clash-rs core version formatting — by @ArakawaHenri in #3826
• Fixed state panic when optional ManagedState values are absent — by @Sn0wo2 in #3706
• Fixed delay-chip color handling — by @SherkeyXD in #3192
• Fixed TUN permission warning visibility — by @Rbqwow in #3160
• Fixed service-install and Lua-ordering issues — by @MNDIA in #1866
• Fixed port mismatch issues — by @trhao99 in #1782

Breaking changes

Clash Nyanpasu 2.0 contains several major compatibility changes.

• Migrated from Tauri v1 to Tauri v2 — by @greenhat616 in #1510
• Removed the legacy UI — by @keiko233 in #4508
• Migrated profiles to the new profile-domain/runtime-pipeline architecture — by @greenhat616
• Migrated application state to typed actors — by @greenhat616, @4o3F
• Moved the core lifecycle to CoreControl — by @greenhat616 in #5182
• Reworked profile Specta bindings to match the serialized wire format — by @greenhat616 in #4920
• Changed profile serialization to avoid integer type mismatches — by @greenhat616 in #3364
• Dropped 32-bit x86 (i686) builds — by @greenhat616 in #4908
• Dropped ARMv7 / armel / armhf builds — by @greenhat616 in #4904
• Raised the distributed x86 baseline to hardware AES and introduced gxhash — by @greenhat616 in #4903
• Replaced OpenSSL with rustls — by @greenhat616
• Replaced isahc with reqwest — by @greenhat616
• Updated macOS builds to the Xcode 16 toolchain — by @greenhat616
• Updated Mihomo AMD64 packaging to v2 — by @3gf8jv4dv in #4914

Configuration migration is performed automatically during upgrade. Nyanpasu now creates migration backups, but keeping an additional manual backup is recommended for beta testing.

Technology and tooling updates

• React 19 — by @greenhat616
• Tauri 2 — by @greenhat616
• Tailwind CSS 4 — by @greenhat616, @keiko233
• Material UI 7 migration work — by @greenhat616, @keiko233
• TanStack Router — by @greenhat616, @keiko233
• TanStack Table 9 — by @greenhat616 in #5205
• Framer Motion 12 — by @greenhat616
• Monaco Editor 0.56 — by @greenhat616 in #5214
• Specta 2 — by @greenhat616 in #4602
• Boa 0.22 — by @greenhat616
• Deno-based project tooling — by @keiko233
• Replaced lodash-es with es-toolkit — by @greenhat616 in #5426
• Replaced Sass with Tailwind and plain CSS — by @keiko233
• Reorganized the frontend into workspace packages — by @keiko233
• Migrated project scripts and version-generation tooling to Deno — by @keiko233

Beta notice

2.0.0-beta.1 is the first public beta built on the new 2.0 architecture.

Please report regressions, migration failures, crashes, performance issues and platform-specific problems through GitHub Issues. Diagnostic logs and reproduction steps are especially useful during the beta period.

Contributors

Thanks to all contributors involved in the 2.0 development cycle, including:

@greenhat616, @keiko233, @4o3F, @3gf8jv4dv, @Slinetrac, @xmh0511, @kolya13245, @Jimie165, @moduvoice, @latin-1, @yokinanya, @C4a15Wh, @Bihrys, @temp-maker-temp, @lmmqxyx404, @ArakawaHenri, @Sn0wo2, @SherkeyXD, @Rbqwow, @legiz-ru, @MNDIA, @trhao99 and others.

---

Full Changelog:
https://github.com/libnyanpasu/clash-nyanpasu/compare/v1.6.1...v2.0.0-beta.1