File Conventions

Routes

pages/index.vue       -> /
pages/about.vue       -> /about
pages/post/[id].vue   -> /post/:id
pages/docs/[...slug].vue -> /docs/:slug*

Components

components/AppButton.vue -> <AppButton />

Component names are inferred from filenames and paths.

Layouts

layouts/default.vue
layouts/dashboard.vue

Use from pages:

definePageMeta({ layout: 'dashboard' })

App shell

app.vue
app/app.vue

Use <ResuxPage /> and <ResuxLayout /> inside the app shell.

Error page

error.vue
app/error.vue

Use for custom 404/500 rendering.

Middleware

middleware/auth.ts
middleware/analytics.global.ts

• Normal files run when referenced by page meta.
• .global.ts files run for every route.

Plugins

plugins/app.ts

Export defineResuxPlugin.

Server handlers

server/api/stats.ts
server/routes/robots.txt.ts

• server/api maps under /api.
• server/routes maps from the root.

Request middleware

server/middleware/headers.ts

Runs before server handlers, public files, and page rendering.

Vue islands

islands/vue/CounterIsland.vue

Use with:

<VueIsland name="CounterIsland" :props="{ start: 1 }" />

Static public files

public/favicon.svg -> /favicon.svg
public/robots.txt  -> /robots.txt

Build output

.resux/
.output/

Do not commit these unless you intentionally deploy generated output.