文档基于文件的

服务器模式和客户端模式

Nexy 项目是 服务器渲染 或 客户端路由，就像 Next.js 项目是在服务器或客户端应用程序上渲染的页面。 nexyconfig.py 中的 useCSR 选择。

服务器模式（`useCSR = False`）

nexyconfig.py

from nexy.core.models import NexyConfigModelfrom nexy.frontend import react  class NexyConfig(NexyConfigModel):    useFF = react()

src/

routes/

layout.nexydocument

index.nexypage

api/users.pyAPI handler

components/Counter.tsx island

nexyconfig.py

class NexyConfig(NexyConfigModel):    useFF = react()    useCSR = True

页面是客户端框架的文件：.tsx for React、.vue、.svelte。
.md 和 .mdx 文件保留有效的路由：Nexy 将它们呈现在客户端布局内的服务器上，并且客户端路由器从那里接管导航。
任何框架（layout.tsx、layout.vue、layout.svelte）的根布局都拥有 <!DOCTYPE html>、<html>、<head> 和 <body>，就像 Next.js App Router 的根布局一样。 Nexy 在 Node 中渲染它作为第一个响应，并且框架水合整个文档。请参阅 layout.tsx。
.py 文件是由 FastAPI 提供的 API 处理程序，位于客户端路由旁边。
根本没有 .nexy 文件，也没有 layout.nexy。
页面之间的导航发生在浏览器中。

src/routes/

layout.tsxdocument

index.tsxpage

users.tsxpage

api/users.pyAPI handler

Nexy 在 nx dev、nx start 和 nx build 之前检查项目并停止并显示文件列表：

模式	被拒绝	留言
服务器	`src/routes/` 下的 `.tsx`、`.jsx`、`.vue` 或 `.svelte`	将组件移动到 `src/components/`，或设置 `useCSR = True`
客户	`src/routes/` 下的任何 `.nexy` 文件	将它们编写为框架组件，或设置 `useCSR = False`
两者	`useFF` 中不止一个前端框架	`useFF must configure exactly one frontend framework`
客户	`useRouter`（模块化路由器）	`useCSR requires file-based routing`
客户	没有 `useFF`	`useCSR requires a client framework`

此检查将忽略以 _ 或 . 开头的文件和文件夹。