nargo-server

Nargo 高性能开发与预览服务器，基于异步 I/O 构建的极速开发环境。

📖 简介

nargo-server 是 Nargo 框架的专用 Web 服务器组件。它不仅为开发者提供了带有即时编译（JIT）和文件监听功能的开发环境，还支持对生产产物进行高性能的静态资源预览。

✨ 核心特性

• 双模式切换:
  • Dev 模式: 集成文件系统监听（notify），自动触发重编译，支持热更新。
  • Serve 模式: 高性能静态文件服务器，用于生产环境模拟与预览。
• 异步驱动: 基于 axum 和 tokio 构建，具备极高的并发处理能力。
• 集成监听机制: 内置 watcher 线程，实时感知项目根目录下的文件变更。
• SPA 回退支持: 内置 fallback 机制，完美支持单页应用（SPA）的路由跳转。

🏗️ 核心数据结构

• ServerOptions: 服务器启动参数，包括运行模式（Dev/Serve）、监听地址及端口。
• ServerState: 全局共享状态，管理编译器实例、配置上下文及运行模式。
• ServerMode: 明确区分开发环境与预览环境的行为差异。

🔗 相关项目

• nargo-compiler: 为开发模式提供即时编译能力支撑。
• nargo-config: 提供服务器所需的网络配置与根目录信息。