@moriajs/core 0.1.1 → 0.2.0

package/.turbo/turbo-build.log

@@ -1,4 +1,4 @@
 
-> @moriajs/core@0.1.1 build C:\Codes\node\2026\github\moriajs\packages\core
+> @moriajs/core@0.2.0 build C:\Codes\node\2026\github\moriajs\packages\core
 > tsc
 

package/dist/app.d.ts

@@ -1,6 +1,7 @@
 import { type FastifyInstance, type FastifyServerOptions } from 'fastify';
 import { type MoriaConfig } from './config.js';
 import { type MoriaPlugin } from './plugins.js';
+import type { ViteDevServer } from 'vite';
 /**
  * Options for creating a MoriaJS application.
  */
@@ -17,6 +18,8 @@ export interface MoriaAppOptions {
 export interface MoriaApp {
     /** The underlying Fastify instance */
     server: FastifyInstance;
+    /** The Vite dev server (only in development mode) */
+    vite?: ViteDevServer;
     /** Register a MoriaJS plugin */
     use: (plugin: MoriaPlugin) => Promise<void>;
     /** Start the server */
@@ -34,7 +37,7 @@ export interface MoriaApp {
  * ```ts
  * import { createApp } from '@moriajs/core';
  *
- * const app = await createApp();
+ * const app = await createApp({ config: { mode: 'development' } });
  * await app.listen({ port: 3000 });
  * ```
  */

package/dist/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA,OAAgB,EAAE,KAAK,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAKnF,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,mDAAmD;IACnD,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC9B,wCAAwC;IACxC,cAAc,CAAC,EAAE,oBAAoB,CAAC;CACzC;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACrB,sCAAsC;IACtC,MAAM,EAAE,eAAe,CAAC;IACxB,gCAAgC;IAChC,GAAG,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,uBAAuB;IACvB,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACxE,sBAAsB;IACtB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,SAAS,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,QAAQ,CAAC,CA0DhF"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA,OAAgB,EAAE,KAAK,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAOnF,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,mDAAmD;IACnD,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC9B,wCAAwC;IACxC,cAAc,CAAC,EAAE,oBAAoB,CAAC;CACzC;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACrB,sCAAsC;IACtC,MAAM,EAAE,eAAe,CAAC;IACxB,qDAAqD;IACrD,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,gCAAgC;IAChC,GAAG,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,uBAAuB;IACvB,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACxE,sBAAsB;IACtB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,SAAS,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,QAAQ,CAAC,CA4EhF"}

package/dist/app.js

@@ -3,6 +3,10 @@ import cors from '@fastify/cors';
 import cookie from '@fastify/cookie';
 import compress from '@fastify/compress';
 import helmet from '@fastify/helmet';
+import path from 'node:path';
+import fs from 'node:fs';
+import { createViteDevMiddleware, serveProductionAssets } from './vite.js';
+import { registerRoutes } from './router.js';
 /**
  * Create a new MoriaJS application.
  *
@@ -10,19 +14,21 @@ import helmet from '@fastify/helmet';
  * ```ts
  * import { createApp } from '@moriajs/core';
  *
- * const app = await createApp();
+ * const app = await createApp({ config: { mode: 'development' } });
  * await app.listen({ port: 3000 });
  * ```
  */
 export async function createApp(options = {}) {
     const config = options.config ?? {};
+    const mode = config.mode ?? (process.env.NODE_ENV === 'production' ? 'production' : 'development');
+    const rootDir = config.rootDir ?? process.cwd();
     const port = config.server?.port ?? 3000;
     const host = config.server?.host ?? '0.0.0.0';
     // Create Fastify instance with sensible defaults
     const server = Fastify({
         logger: {
             level: config.server?.logLevel ?? 'info',
-            transport: process.env.NODE_ENV !== 'production'
+            transport: mode !== 'production'
                 ? { target: 'pino-pretty', options: { colorize: true } }
                 : undefined,
         },
@@ -37,14 +43,28 @@ export async function createApp(options = {}) {
     await server.register(compress);
     await server.register(helmet, {
         // Relax CSP in development for Vite HMR
-        contentSecurityPolicy: process.env.NODE_ENV === 'production',
+        contentSecurityPolicy: mode === 'production',
     });
     // Health check route
     server.get('/health', async () => ({ status: 'ok', timestamp: new Date().toISOString() }));
+    // ─── Vite Integration ────────────────────────────────────
+    let vite;
+    if (mode === 'development') {
+        vite = await createViteDevMiddleware(server, { ...config, rootDir });
+    }
+    else {
+        await serveProductionAssets(server, { ...config, rootDir });
+    }
+    // ─── File-Based Routing ──────────────────────────────────
+    const routesDir = path.resolve(rootDir, config.routes?.dir ?? 'src/routes');
+    if (fs.existsSync(routesDir)) {
+        await registerRoutes(server, routesDir, { mode, config });
+    }
     // Plugin registry
     const plugins = [];
     const app = {
         server,
+        vite,
         async use(plugin) {
             plugins.push(plugin);
             await plugin.register({ server, config });

package/dist/app.js.map

@@ -1 +1 @@
-{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA,OAAO,OAA4D,MAAM,SAAS,CAAC;AACnF,OAAO,IAAI,MAAM,eAAe,CAAC;AACjC,OAAO,MAAM,MAAM,iBAAiB,CAAC;AACrC,OAAO,QAAQ,MAAM,mBAAmB,CAAC;AACzC,OAAO,MAAM,MAAM,iBAAiB,CAAC;AA6BrC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,UAA2B,EAAE;IACzD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;IACpC,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,IAAI,IAAI,CAAC;IACzC,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,IAAI,SAAS,CAAC;IAE9C,iDAAiD;IACjD,MAAM,MAAM,GAAG,OAAO,CAAC;QACnB,MAAM,EAAE;YACJ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,IAAI,MAAM;YACxC,SAAS,EACL,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY;gBACjC,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;gBACxD,CAAC,CAAC,SAAS;SACtB;QACD,GAAG,OAAO,CAAC,cAAc;KAC5B,CAAC,CAAC;IAEH,wBAAwB;IACxB,MAAM,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE;QACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,IAAI;QAC3C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,WAAW,IAAI,IAAI;KACxD,CAAC,CAAC;IAEH,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9B,MAAM,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAChC,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE;QAC1B,wCAAwC;QACxC,qBAAqB,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY;KAC/D,CAAC,CAAC;IAEH,qBAAqB;IACrB,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC;IAE3F,kBAAkB;IAClB,MAAM,OAAO,GAAkB,EAAE,CAAC;IAElC,MAAM,GAAG,GAAa;QAClB,MAAM;QAEN,KAAK,CAAC,GAAG,CAAC,MAAmB;YACzB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACrB,MAAM,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9C,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,aAAa;YACtB,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC;gBAC7B,IAAI,EAAE,aAAa,EAAE,IAAI,IAAI,IAAI;gBACjC,IAAI,EAAE,aAAa,EAAE,IAAI,IAAI,IAAI;aACpC,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,KAAK,CAAC,KAAK;YACP,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACzB,CAAC;KACJ,CAAC;IAEF,OAAO,GAAG,CAAC;AACf,CAAC"}
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -3,6 +3,10 @@
  * Used in `moria.config.ts` files in user projects.
  */
 export interface MoriaConfig {
+    /** Application mode */
+    mode?: 'development' | 'production';
+    /** Project root directory (auto-detected if not set) */
+    rootDir?: string;
     /** Server configuration */
     server?: {
         /** Port to listen on (default: 3000) */
@@ -41,6 +45,13 @@ export interface MoriaConfig {
     vite?: {
         /** Path to Vite config file */
         configFile?: string;
+        /** Client entry point (default: '/src/entry-client.ts') */
+        clientEntry?: string;
+    };
+    /** File-based routing configuration */
+    routes?: {
+        /** Routes directory relative to rootDir (default: 'src/routes') */
+        dir?: string;
     };
 }
 /**

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,WAAW;IACxB,2BAA2B;IAC3B,MAAM,CAAC,EAAE;QACL,wCAAwC;QACxC,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,2CAA2C;QAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,kCAAkC;QAClC,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;QAC9E,yBAAyB;QACzB,IAAI,CAAC,EAAE;YACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC;YACrC,WAAW,CAAC,EAAE,OAAO,CAAC;SACzB,CAAC;KACL,CAAC;IAEF,6BAA6B;IAC7B,QAAQ,CAAC,EAAE;QACP,kDAAkD;QAClD,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,qBAAqB;QACrB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,+CAA+C;QAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IAEF,mCAAmC;IACnC,IAAI,CAAC,EAAE;QACH,qBAAqB;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,2CAA2C;QAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,gCAAgC;QAChC,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,yCAAyC;QACzC,aAAa,CAAC,EAAE,OAAO,CAAC;KAC3B,CAAC;IAEF,iCAAiC;IACjC,IAAI,CAAC,EAAE;QACH,+BAA+B;QAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACL;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAE7D"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,WAAW;IACxB,uBAAuB;IACvB,IAAI,CAAC,EAAE,aAAa,GAAG,YAAY,CAAC;IAEpC,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,2BAA2B;IAC3B,MAAM,CAAC,EAAE;QACL,wCAAwC;QACxC,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,2CAA2C;QAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,kCAAkC;QAClC,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;QAC9E,yBAAyB;QACzB,IAAI,CAAC,EAAE;YACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC;YACrC,WAAW,CAAC,EAAE,OAAO,CAAC;SACzB,CAAC;KACL,CAAC;IAEF,6BAA6B;IAC7B,QAAQ,CAAC,EAAE;QACP,kDAAkD;QAClD,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,qBAAqB;QACrB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,+CAA+C;QAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IAEF,mCAAmC;IACnC,IAAI,CAAC,EAAE;QACH,qBAAqB;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,2CAA2C;QAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,gCAAgC;QAChC,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,yCAAyC;QACzC,aAAa,CAAC,EAAE,OAAO,CAAC;KAC3B,CAAC;IAEF,iCAAiC;IACjC,IAAI,CAAC,EAAE;QACH,+BAA+B;QAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,2DAA2D;QAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IAEF,uCAAuC;IACvC,MAAM,CAAC,EAAE;QACL,mEAAmE;QACnE,GAAG,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACL;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAE7D"}

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAiDA;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,YAAY,CAAC,MAAmB;IAC5C,OAAO,MAAM,CAAC;AAClB,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AA+DA;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,YAAY,CAAC,MAAmB;IAC5C,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/index.d.ts

@@ -2,12 +2,15 @@
  * @moriajs/core
  *
  * Framework core: Fastify server factory with sensible defaults,
- * plugin registration, and configuration system.
+ * plugin registration, Vite integration, and file-based routing.
  */
 export { createApp } from './app.js';
 export { defineConfig } from './config.js';
 export { defineMoriaPlugin } from './plugins.js';
+export { createViteDevMiddleware, serveProductionAssets, getHtmlScripts } from './vite.js';
+export { scanRoutes, registerRoutes, filePathToUrlPath } from './router.js';
 export type { MoriaApp, MoriaAppOptions } from './app.js';
 export type { MoriaConfig } from './config.js';
 export type { MoriaPlugin, MoriaPluginContext } from './plugins.js';
+export type { RouteEntry, RouteHandler } from './router.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC1D,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3F,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAE5E,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC1D,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACpE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -2,9 +2,11 @@
  * @moriajs/core
  *
  * Framework core: Fastify server factory with sensible defaults,
- * plugin registration, and configuration system.
+ * plugin registration, Vite integration, and file-based routing.
  */
 export { createApp } from './app.js';
 export { defineConfig } from './config.js';
 export { defineMoriaPlugin } from './plugins.js';
+export { createViteDevMiddleware, serveProductionAssets, getHtmlScripts } from './vite.js';
+export { scanRoutes, registerRoutes, filePathToUrlPath } from './router.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3F,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/router.d.ts

@@ -0,0 +1,80 @@
+/**
+ * File-based routing for MoriaJS.
+ *
+ * Scans `src/routes/` for route files and auto-registers them with Fastify.
+ *
+ * Convention:
+ *   src/routes/api/hello.ts       → GET /api/hello       (API handler)
+ *   src/routes/api/users/[id].ts  → GET /api/users/:id   (API handler)
+ *   src/routes/pages/index.ts     → GET /                (SSR page)
+ *   src/routes/pages/about.ts     → GET /about           (SSR page)
+ *
+ * API routes export named HTTP method functions:
+ *   export function GET(request, reply) { ... }
+ *
+ * Page routes export a Mithril component + optional data loader:
+ *   export default { view() { return m('h1', 'Hello') } }
+ *   export async function getServerData(request) { return { user: ... } }
+ */
+import type { FastifyInstance, FastifyRequest, FastifyReply } from 'fastify';
+import type { MoriaConfig } from './config.js';
+/** Supported HTTP methods in route files. */
+declare const HTTP_METHODS: readonly ["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS"];
+type HttpMethod = (typeof HTTP_METHODS)[number];
+/** Handler function exported from a route file. */
+export type RouteHandler = (request: FastifyRequest, reply: FastifyReply) => unknown | Promise<unknown>;
+/** Data loader for page routes — runs on server before render. */
+export type GetServerData = (request: FastifyRequest) => unknown | Promise<unknown>;
+/** Discovered route entry. */
+export interface RouteEntry {
+    /** File path relative to routes dir */
+    filePath: string;
+    /** URL path pattern (e.g., /api/users/:id) */
+    urlPath: string;
+    /** Route type: 'api' or 'page' */
+    type: 'api' | 'page';
+    /** HTTP method → handler map (API routes) */
+    methods: Partial<Record<Lowercase<HttpMethod>, RouteHandler>>;
+    /** Mithril component (page routes only) */
+    component?: unknown;
+    /** Server data loader (page routes only) */
+    getServerData?: GetServerData;
+}
+/**
+ * Options for route registration.
+ */
+export interface RegisterRoutesOptions {
+    /** Application mode */
+    mode?: 'development' | 'production';
+    /** MoriaJS config for renderer options */
+    config?: Partial<MoriaConfig>;
+}
+/**
+ * Convert a file path to a URL path.
+ *
+ * - Strips file extension
+ * - Converts `[param]` → `:param`
+ * - Converts `[...slug]` → `*`
+ * - Converts `index` → `/`
+ *
+ * @example
+ * filePathToUrlPath('api/users/[id].ts') → '/api/users/:id'
+ * filePathToUrlPath('pages/index.ts')    → '/'
+ * filePathToUrlPath('pages/about.ts')    → '/about'
+ */
+export declare function filePathToUrlPath(filePath: string): string;
+/**
+ * Scan a directory for route files and return discovered routes.
+ *
+ * @param routesDir - Absolute path to the routes directory (e.g., `<project>/src/routes`)
+ */
+export declare function scanRoutes(routesDir: string): Promise<RouteEntry[]>;
+/**
+ * Register discovered routes with a Fastify server.
+ *
+ * Page routes with Mithril components are auto-wrapped with SSR rendering.
+ * API routes are registered directly as Fastify handlers.
+ */
+export declare function registerRoutes(server: FastifyInstance, routesDir: string, options?: RegisterRoutesOptions): Promise<RouteEntry[]>;
+export {};
+//# sourceMappingURL=router.d.ts.map

package/dist/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAI7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,6CAA6C;AAC7C,QAAA,MAAM,YAAY,uEAAwE,CAAC;AAC3F,KAAK,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhD,mDAAmD;AACnD,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAExG,kEAAkE;AAClE,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpF,8BAA8B;AAC9B,MAAM,WAAW,UAAU;IACvB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;IACrB,6CAA6C;IAC7C,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC;IAC9D,2CAA2C;IAC3C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,aAAa,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC,uBAAuB;IACvB,IAAI,CAAC,EAAE,aAAa,GAAG,YAAY,CAAC;IACpC,0CAA0C;IAC1C,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;CACjC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAkC1D;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAgGzE;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAChC,MAAM,EAAE,eAAe,EACvB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,qBAA0B,GACpC,OAAO,CAAC,UAAU,EAAE,CAAC,CAsDvB"}

package/dist/router.js

@@ -0,0 +1,208 @@
+/**
+ * File-based routing for MoriaJS.
+ *
+ * Scans `src/routes/` for route files and auto-registers them with Fastify.
+ *
+ * Convention:
+ *   src/routes/api/hello.ts       → GET /api/hello       (API handler)
+ *   src/routes/api/users/[id].ts  → GET /api/users/:id   (API handler)
+ *   src/routes/pages/index.ts     → GET /                (SSR page)
+ *   src/routes/pages/about.ts     → GET /about           (SSR page)
+ *
+ * API routes export named HTTP method functions:
+ *   export function GET(request, reply) { ... }
+ *
+ * Page routes export a Mithril component + optional data loader:
+ *   export default { view() { return m('h1', 'Hello') } }
+ *   export async function getServerData(request) { return { user: ... } }
+ */
+import { glob } from 'glob';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+/** Supported HTTP methods in route files. */
+const HTTP_METHODS = ['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'HEAD', 'OPTIONS'];
+/**
+ * Convert a file path to a URL path.
+ *
+ * - Strips file extension
+ * - Converts `[param]` → `:param`
+ * - Converts `[...slug]` → `*`
+ * - Converts `index` → `/`
+ *
+ * @example
+ * filePathToUrlPath('api/users/[id].ts') → '/api/users/:id'
+ * filePathToUrlPath('pages/index.ts')    → '/'
+ * filePathToUrlPath('pages/about.ts')    → '/about'
+ */
+export function filePathToUrlPath(filePath) {
+    // Remove extension
+    let route = filePath.replace(/\.(ts|js|mts|mjs)$/, '');
+    // Normalize separators
+    route = route.replace(/\\/g, '/');
+    // Convert [param] → :param
+    route = route.replace(/\[([^\].]+)\]/g, ':$1');
+    // Convert [...slug] → *
+    route = route.replace(/\[\.\.\.([^\]]+)\]/g, '*');
+    // Handle pages prefix — strip "pages" and make root-relative
+    if (route.startsWith('pages/')) {
+        route = route.slice(5); // remove "pages"
+    }
+    // Handle api prefix — keep "api"
+    // (no transformation needed)
+    // Handle index files → parent path
+    route = route.replace(/\/index$/, '');
+    // Ensure leading slash
+    if (!route.startsWith('/')) {
+        route = '/' + route;
+    }
+    // Root case
+    if (route === '') {
+        route = '/';
+    }
+    return route;
+}
+/**
+ * Scan a directory for route files and return discovered routes.
+ *
+ * @param routesDir - Absolute path to the routes directory (e.g., `<project>/src/routes`)
+ */
+export async function scanRoutes(routesDir) {
+    const pattern = '**/*.{ts,js,mts,mjs}';
+    const files = await glob(pattern, {
+        cwd: routesDir,
+        posix: true,
+        ignore: ['**/_*', '**/*.d.ts', '**/*.test.*', '**/*.spec.*'],
+    });
+    const routes = [];
+    for (const file of files) {
+        const urlPath = filePathToUrlPath(file);
+        const type = file.startsWith('api/') ? 'api' : 'page';
+        const absolutePath = path.resolve(routesDir, file);
+        const fileUrl = pathToFileURL(absolutePath).href;
+        // Dynamically import the route module
+        let mod;
+        try {
+            mod = await import(fileUrl);
+        }
+        catch (err) {
+            console.warn(`[moria] Failed to load route: ${file}`, err);
+            continue;
+        }
+        if (type === 'page') {
+            // ─── Page route: expects default Mithril component ───────
+            const component = mod.default;
+            const getServerData = typeof mod.getServerData === 'function'
+                ? mod.getServerData
+                : undefined;
+            // Page routes can also export raw HTTP handlers (backward compat)
+            if (component && typeof component === 'object' && 'view' in component) {
+                routes.push({
+                    filePath: file,
+                    urlPath,
+                    type: 'page',
+                    methods: {},
+                    component,
+                    getServerData,
+                });
+                continue;
+            }
+            // Fallback: if default export is a function, treat as API-style handler
+            if (typeof component === 'function') {
+                routes.push({
+                    filePath: file,
+                    urlPath,
+                    type: 'page',
+                    methods: { get: component },
+                });
+                continue;
+            }
+            // Also check for named HTTP method exports
+            const methods = {};
+            for (const method of HTTP_METHODS) {
+                const handler = mod[method] ?? mod[method.toLowerCase()];
+                if (typeof handler === 'function') {
+                    methods[method.toLowerCase()] = handler;
+                }
+            }
+            if (Object.keys(methods).length > 0) {
+                routes.push({ filePath: file, urlPath, type: 'page', methods });
+                continue;
+            }
+            console.warn(`[moria] Page route has no component or handlers: ${file}`);
+        }
+        else {
+            // ─── API route: expects named HTTP method exports ────────
+            const methods = {};
+            for (const method of HTTP_METHODS) {
+                const handler = mod[method] ?? mod[method.toLowerCase()];
+                if (typeof handler === 'function') {
+                    methods[method.toLowerCase()] = handler;
+                }
+            }
+            // Also support default export as GET handler
+            if (typeof mod.default === 'function' && !methods.get) {
+                methods.get = mod.default;
+            }
+            if (Object.keys(methods).length === 0) {
+                console.warn(`[moria] Route file has no handlers: ${file}`);
+                continue;
+            }
+            routes.push({ filePath: file, urlPath, type: 'api', methods });
+        }
+    }
+    return routes;
+}
+/**
+ * Register discovered routes with a Fastify server.
+ *
+ * Page routes with Mithril components are auto-wrapped with SSR rendering.
+ * API routes are registered directly as Fastify handlers.
+ */
+export async function registerRoutes(server, routesDir, options = {}) {
+    const routes = await scanRoutes(routesDir);
+    const mode = options.mode ?? 'development';
+    const config = options.config ?? {};
+    for (const route of routes) {
+        // ─── Page route with Mithril component → SSR handler ─────
+        if (route.component) {
+            const component = route.component;
+            const getServerData = route.getServerData;
+            const clientEntry = config.vite?.clientEntry ?? '/src/entry-client.ts';
+            server.route({
+                method: 'GET',
+                url: route.urlPath,
+                handler: async (request, reply) => {
+                    // Load server data if available
+                    let initialData;
+                    if (getServerData) {
+                        initialData = (await getServerData(request));
+                    }
+                    // Dynamic import of renderer (avoids circular deps)
+                    const { renderToString } = await import('@moriajs/renderer');
+                    const html = await renderToString(component, {
+                        title: component.title ?? 'MoriaJS App',
+                        initialData,
+                        mode,
+                        clientEntry,
+                    });
+                    reply.type('text/html');
+                    return html;
+                },
+            });
+            server.log.info(`Page:  GET ${route.urlPath} → ${route.filePath} (SSR)`);
+            continue;
+        }
+        // ─── API / raw handler routes ────────────────────────────
+        for (const [method, handler] of Object.entries(route.methods)) {
+            server.route({
+                method: method.toUpperCase(),
+                url: route.urlPath,
+                handler: handler,
+            });
+            server.log.info(`Route: ${method.toUpperCase()} ${route.urlPath} → ${route.filePath}`);
+        }
+    }
+    server.log.info(`Registered ${routes.length} file-based route(s)`);
+    return routes;
+}
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"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"}

package/dist/vite.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Vite integration for MoriaJS.
+ *
+ * Provides Vite dev server in middleware mode (development)
+ * and static file serving for production builds.
+ */
+import type { FastifyInstance } from 'fastify';
+import type { ViteDevServer } from 'vite';
+import { type MoriaConfig } from './config.js';
+/**
+ * Attach Vite dev server to Fastify in middleware mode.
+ * This enables HMR and on-the-fly module transformation.
+ */
+export declare function createViteDevMiddleware(server: FastifyInstance, config?: Partial<MoriaConfig>): Promise<ViteDevServer>;
+/**
+ * Serve production-built client assets via @fastify/static.
+ */
+export declare function serveProductionAssets(server: FastifyInstance, config?: Partial<MoriaConfig>): Promise<void>;
+/**
+ * Generate the HTML shell for a page, with appropriate script tags
+ * depending on dev vs production mode.
+ */
+export declare function getHtmlScripts(mode: 'development' | 'production', config?: Partial<MoriaConfig>): string;
+//# sourceMappingURL=vite.d.ts.map

package/dist/vite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;GAGG;AACH,wBAAsB,uBAAuB,CACzC,MAAM,EAAE,eAAe,EACvB,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,GAClC,OAAO,CAAC,aAAa,CAAC,CA4BxB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACvC,MAAM,EAAE,eAAe,EACvB,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,GAClC,OAAO,CAAC,IAAI,CAAC,CAaf;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,aAAa,GAAG,YAAY,EAAE,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,MAAM,CAW5G"}

package/dist/vite.js

@@ -0,0 +1,63 @@
+/**
+ * Vite integration for MoriaJS.
+ *
+ * Provides Vite dev server in middleware mode (development)
+ * and static file serving for production builds.
+ */
+/**
+ * Attach Vite dev server to Fastify in middleware mode.
+ * This enables HMR and on-the-fly module transformation.
+ */
+export async function createViteDevMiddleware(server, config = {}) {
+    const { createServer: createViteServer } = await import('vite');
+    const middie = (await import('@fastify/middie')).default;
+    // Register Express-style middleware support
+    await server.register(middie);
+    const vite = await createViteServer({
+        root: config.rootDir ?? process.cwd(),
+        configFile: config.vite?.configFile,
+        server: {
+            middlewareMode: true,
+            hmr: true,
+        },
+        appType: 'custom',
+    });
+    // Use Vite's connect middleware stack
+    server.use(vite.middlewares);
+    server.log.info('Vite dev server attached (HMR enabled)');
+    // Ensure Vite is closed when Fastify shuts down
+    server.addHook('onClose', async () => {
+        await vite.close();
+    });
+    return vite;
+}
+/**
+ * Serve production-built client assets via @fastify/static.
+ */
+export async function serveProductionAssets(server, config = {}) {
+    const path = await import('node:path');
+    const fastifyStatic = (await import('@fastify/static')).default;
+    const distDir = path.resolve(config.rootDir ?? process.cwd(), 'dist', 'client');
+    await server.register(fastifyStatic, {
+        root: distDir,
+        prefix: '/assets/',
+        decorateReply: false,
+    });
+    server.log.info(`Serving static assets from ${distDir}`);
+}
+/**
+ * Generate the HTML shell for a page, with appropriate script tags
+ * depending on dev vs production mode.
+ */
+export function getHtmlScripts(mode, config = {}) {
+    if (mode === 'development') {
+        const clientEntry = config.vite?.clientEntry ?? '/src/entry-client.ts';
+        return [
+            `<script type="module" src="/@vite/client"></script>`,
+            `<script type="module" src="${clientEntry}"></script>`,
+        ].join('\n    ');
+    }
+    // Production: reference the built bundle
+    return `<script type="module" src="/assets/entry-client.js"></script>`;
+}
+//# sourceMappingURL=vite.js.map

package/dist/vite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.js","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CACzC,MAAuB,EACvB,SAA+B,EAAE;IAEjC,MAAM,EAAE,YAAY,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;IAChE,MAAM,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,OAAO,CAAC;IAEzD,4CAA4C;IAC5C,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAE9B,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC;QAChC,IAAI,EAAE,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE;QACrC,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE,UAAU;QACnC,MAAM,EAAE;YACJ,cAAc,EAAE,IAAI;YACpB,GAAG,EAAE,IAAI;SACZ;QACD,OAAO,EAAE,QAAQ;KACpB,CAAC,CAAC;IAEH,sCAAsC;IACtC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAE7B,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;IAE1D,gDAAgD;IAChD,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;QACjC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACvC,MAAuB,EACvB,SAA+B,EAAE;IAEjC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;IACvC,MAAM,aAAa,GAAG,CAAC,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,OAAO,CAAC;IAEhE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAEhF,MAAM,MAAM,CAAC,QAAQ,CAAC,aAAa,EAAE;QACjC,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,UAAU;QAClB,aAAa,EAAE,KAAK;KACvB,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,8BAA8B,OAAO,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAkC,EAAE,SAA+B,EAAE;IAChG,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;QACzB,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,EAAE,WAAW,IAAI,sBAAsB,CAAC;QACvE,OAAO;YACH,qDAAqD;YACrD,8BAA8B,WAAW,aAAa;SACzD,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrB,CAAC;IAED,yCAAyC;IACzC,OAAO,+DAA+D,CAAC;AAC3E,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moriajs/core",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "type": "module",
   "description": "MoriaJS framework core — Fastify server, Vite integration, and routing",
   "main": "./dist/index.js",
@@ -18,13 +18,19 @@
     "@fastify/compress": "^8.0.0",
     "@fastify/static": "^9.0.0",
     "@fastify/helmet": "^13.0.0",
-    "pino-pretty": "^13.0.0"
+    "@fastify/middie": "^9.0.0",
+    "pino-pretty": "^13.0.0",
+    "vite": "^6.0.0",
+    "glob": "^11.0.0"
   },
   "devDependencies": {
     "typescript": "^5.7.0",
     "rimraf": "^6.0.0",
     "@types/node": "^22.0.0"
   },
+  "peerDependencies": {
+    "@moriajs/renderer": "0.2.0"
+  },
   "license": "MIT",
   "author": "Guntur-D <guntur.d.npm@gmail.com>",
   "repository": {

package/src/app.ts

@@ -3,8 +3,13 @@ import cors from '@fastify/cors';
 import cookie from '@fastify/cookie';
 import compress from '@fastify/compress';
 import helmet from '@fastify/helmet';
+import path from 'node:path';
+import fs from 'node:fs';
 import { type MoriaConfig } from './config.js';
 import { type MoriaPlugin } from './plugins.js';
+import { createViteDevMiddleware, serveProductionAssets } from './vite.js';
+import { registerRoutes } from './router.js';
+import type { ViteDevServer } from 'vite';
 
 /**
  * Options for creating a MoriaJS application.
@@ -23,6 +28,8 @@ export interface MoriaAppOptions {
 export interface MoriaApp {
     /** The underlying Fastify instance */
     server: FastifyInstance;
+    /** The Vite dev server (only in development mode) */
+    vite?: ViteDevServer;
     /** Register a MoriaJS plugin */
     use: (plugin: MoriaPlugin) => Promise<void>;
     /** Start the server */
@@ -38,12 +45,14 @@ export interface MoriaApp {
  * ```ts
  * import { createApp } from '@moriajs/core';
  *
- * const app = await createApp();
+ * const app = await createApp({ config: { mode: 'development' } });
  * await app.listen({ port: 3000 });
  * ```
  */
 export async function createApp(options: MoriaAppOptions = {}): Promise<MoriaApp> {
     const config = options.config ?? {};
+    const mode = config.mode ?? (process.env.NODE_ENV === 'production' ? 'production' : 'development');
+    const rootDir = config.rootDir ?? process.cwd();
     const port = config.server?.port ?? 3000;
     const host = config.server?.host ?? '0.0.0.0';
 
@@ -52,7 +61,7 @@ export async function createApp(options: MoriaAppOptions = {}): Promise<MoriaApp
         logger: {
             level: config.server?.logLevel ?? 'info',
             transport:
-                process.env.NODE_ENV !== 'production'
+                mode !== 'production'
                     ? { target: 'pino-pretty', options: { colorize: true } }
                     : undefined,
         },
@@ -69,17 +78,33 @@ export async function createApp(options: MoriaAppOptions = {}): Promise<MoriaApp
     await server.register(compress);
     await server.register(helmet, {
         // Relax CSP in development for Vite HMR
-        contentSecurityPolicy: process.env.NODE_ENV === 'production',
+        contentSecurityPolicy: mode === 'production',
     });
 
     // Health check route
     server.get('/health', async () => ({ status: 'ok', timestamp: new Date().toISOString() }));
 
+    // ─── Vite Integration ────────────────────────────────────
+    let vite: ViteDevServer | undefined;
+
+    if (mode === 'development') {
+        vite = await createViteDevMiddleware(server, { ...config, rootDir });
+    } else {
+        await serveProductionAssets(server, { ...config, rootDir });
+    }
+
+    // ─── File-Based Routing ──────────────────────────────────
+    const routesDir = path.resolve(rootDir, config.routes?.dir ?? 'src/routes');
+    if (fs.existsSync(routesDir)) {
+        await registerRoutes(server, routesDir, { mode, config });
+    }
+
     // Plugin registry
     const plugins: MoriaPlugin[] = [];
 
     const app: MoriaApp = {
         server,
+        vite,
 
         async use(plugin: MoriaPlugin) {
             plugins.push(plugin);

package/src/config.ts

@@ -3,6 +3,12 @@
  * Used in `moria.config.ts` files in user projects.
  */
 export interface MoriaConfig {
+    /** Application mode */
+    mode?: 'development' | 'production';
+
+    /** Project root directory (auto-detected if not set) */
+    rootDir?: string;
+
     /** Server configuration */
     server?: {
         /** Port to listen on (default: 3000) */
@@ -44,6 +50,14 @@ export interface MoriaConfig {
     vite?: {
         /** Path to Vite config file */
         configFile?: string;
+        /** Client entry point (default: '/src/entry-client.ts') */
+        clientEntry?: string;
+    };
+
+    /** File-based routing configuration */
+    routes?: {
+        /** Routes directory relative to rootDir (default: 'src/routes') */
+        dir?: string;
     };
 }
 

package/src/index.ts

@@ -2,13 +2,16 @@
  * @moriajs/core
  *
  * Framework core: Fastify server factory with sensible defaults,
- * plugin registration, and configuration system.
+ * plugin registration, Vite integration, and file-based routing.
  */
 
 export { createApp } from './app.js';
 export { defineConfig } from './config.js';
 export { defineMoriaPlugin } from './plugins.js';
+export { createViteDevMiddleware, serveProductionAssets, getHtmlScripts } from './vite.js';
+export { scanRoutes, registerRoutes, filePathToUrlPath } from './router.js';
 
 export type { MoriaApp, MoriaAppOptions } from './app.js';
 export type { MoriaConfig } from './config.js';
 export type { MoriaPlugin, MoriaPluginContext } from './plugins.js';
+export type { RouteEntry, RouteHandler } from './router.js';

package/src/router.ts

@@ -0,0 +1,278 @@
+/**
+ * File-based routing for MoriaJS.
+ *
+ * Scans `src/routes/` for route files and auto-registers them with Fastify.
+ *
+ * Convention:
+ *   src/routes/api/hello.ts       → GET /api/hello       (API handler)
+ *   src/routes/api/users/[id].ts  → GET /api/users/:id   (API handler)
+ *   src/routes/pages/index.ts     → GET /                (SSR page)
+ *   src/routes/pages/about.ts     → GET /about           (SSR page)
+ *
+ * API routes export named HTTP method functions:
+ *   export function GET(request, reply) { ... }
+ *
+ * Page routes export a Mithril component + optional data loader:
+ *   export default { view() { return m('h1', 'Hello') } }
+ *   export async function getServerData(request) { return { user: ... } }
+ */
+
+import type { FastifyInstance, FastifyRequest, FastifyReply } from 'fastify';
+import { glob } from 'glob';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import type { MoriaConfig } from './config.js';
+
+/** Supported HTTP methods in route files. */
+const HTTP_METHODS = ['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'HEAD', 'OPTIONS'] as const;
+type HttpMethod = (typeof HTTP_METHODS)[number];
+
+/** Handler function exported from a route file. */
+export type RouteHandler = (request: FastifyRequest, reply: FastifyReply) => unknown | Promise<unknown>;
+
+/** Data loader for page routes — runs on server before render. */
+export type GetServerData = (request: FastifyRequest) => unknown | Promise<unknown>;
+
+/** Discovered route entry. */
+export interface RouteEntry {
+    /** File path relative to routes dir */
+    filePath: string;
+    /** URL path pattern (e.g., /api/users/:id) */
+    urlPath: string;
+    /** Route type: 'api' or 'page' */
+    type: 'api' | 'page';
+    /** HTTP method → handler map (API routes) */
+    methods: Partial<Record<Lowercase<HttpMethod>, RouteHandler>>;
+    /** Mithril component (page routes only) */
+    component?: unknown;
+    /** Server data loader (page routes only) */
+    getServerData?: GetServerData;
+}
+
+/**
+ * Options for route registration.
+ */
+export interface RegisterRoutesOptions {
+    /** Application mode */
+    mode?: 'development' | 'production';
+    /** MoriaJS config for renderer options */
+    config?: Partial<MoriaConfig>;
+}
+
+/**
+ * Convert a file path to a URL path.
+ *
+ * - Strips file extension
+ * - Converts `[param]` → `:param`
+ * - Converts `[...slug]` → `*`
+ * - Converts `index` → `/`
+ *
+ * @example
+ * filePathToUrlPath('api/users/[id].ts') → '/api/users/:id'
+ * filePathToUrlPath('pages/index.ts')    → '/'
+ * filePathToUrlPath('pages/about.ts')    → '/about'
+ */
+export function filePathToUrlPath(filePath: string): string {
+    // Remove extension
+    let route = filePath.replace(/\.(ts|js|mts|mjs)$/, '');
+
+    // Normalize separators
+    route = route.replace(/\\/g, '/');
+
+    // Convert [param] → :param
+    route = route.replace(/\[([^\].]+)\]/g, ':$1');
+
+    // Convert [...slug] → *
+    route = route.replace(/\[\.\.\.([^\]]+)\]/g, '*');
+
+    // Handle pages prefix — strip "pages" and make root-relative
+    if (route.startsWith('pages/')) {
+        route = route.slice(5); // remove "pages"
+    }
+    // Handle api prefix — keep "api"
+    // (no transformation needed)
+
+    // Handle index files → parent path
+    route = route.replace(/\/index$/, '');
+
+    // Ensure leading slash
+    if (!route.startsWith('/')) {
+        route = '/' + route;
+    }
+
+    // Root case
+    if (route === '') {
+        route = '/';
+    }
+
+    return route;
+}
+
+/**
+ * Scan a directory for route files and return discovered routes.
+ *
+ * @param routesDir - Absolute path to the routes directory (e.g., `<project>/src/routes`)
+ */
+export async function scanRoutes(routesDir: string): Promise<RouteEntry[]> {
+    const pattern = '**/*.{ts,js,mts,mjs}';
+    const files = await glob(pattern, {
+        cwd: routesDir,
+        posix: true,
+        ignore: ['**/_*', '**/*.d.ts', '**/*.test.*', '**/*.spec.*'],
+    });
+
+    const routes: RouteEntry[] = [];
+
+    for (const file of files) {
+        const urlPath = filePathToUrlPath(file);
+        const type: 'api' | 'page' = file.startsWith('api/') ? 'api' : 'page';
+
+        const absolutePath = path.resolve(routesDir, file);
+        const fileUrl = pathToFileURL(absolutePath).href;
+
+        // Dynamically import the route module
+        let mod: Record<string, unknown>;
+        try {
+            mod = await import(fileUrl);
+        } catch (err) {
+            console.warn(`[moria] Failed to load route: ${file}`, err);
+            continue;
+        }
+
+        if (type === 'page') {
+            // ─── Page route: expects default Mithril component ───────
+            const component = mod.default;
+            const getServerData = typeof mod.getServerData === 'function'
+                ? mod.getServerData as GetServerData
+                : undefined;
+
+            // Page routes can also export raw HTTP handlers (backward compat)
+            if (component && typeof component === 'object' && 'view' in component) {
+                routes.push({
+                    filePath: file,
+                    urlPath,
+                    type: 'page',
+                    methods: {},
+                    component,
+                    getServerData,
+                });
+                continue;
+            }
+
+            // Fallback: if default export is a function, treat as API-style handler
+            if (typeof component === 'function') {
+                routes.push({
+                    filePath: file,
+                    urlPath,
+                    type: 'page',
+                    methods: { get: component as RouteHandler },
+                });
+                continue;
+            }
+
+            // Also check for named HTTP method exports
+            const methods: Partial<Record<Lowercase<HttpMethod>, RouteHandler>> = {};
+            for (const method of HTTP_METHODS) {
+                const handler = mod[method] ?? mod[method.toLowerCase()];
+                if (typeof handler === 'function') {
+                    methods[method.toLowerCase() as Lowercase<HttpMethod>] = handler as RouteHandler;
+                }
+            }
+            if (Object.keys(methods).length > 0) {
+                routes.push({ filePath: file, urlPath, type: 'page', methods });
+                continue;
+            }
+
+            console.warn(`[moria] Page route has no component or handlers: ${file}`);
+        } else {
+            // ─── API route: expects named HTTP method exports ────────
+            const methods: Partial<Record<Lowercase<HttpMethod>, RouteHandler>> = {};
+            for (const method of HTTP_METHODS) {
+                const handler = mod[method] ?? mod[method.toLowerCase()];
+                if (typeof handler === 'function') {
+                    methods[method.toLowerCase() as Lowercase<HttpMethod>] = handler as RouteHandler;
+                }
+            }
+
+            // Also support default export as GET handler
+            if (typeof mod.default === 'function' && !methods.get) {
+                methods.get = mod.default as RouteHandler;
+            }
+
+            if (Object.keys(methods).length === 0) {
+                console.warn(`[moria] Route file has no handlers: ${file}`);
+                continue;
+            }
+
+            routes.push({ filePath: file, urlPath, type: 'api', methods });
+        }
+    }
+
+    return routes;
+}
+
+/**
+ * Register discovered routes with a Fastify server.
+ *
+ * Page routes with Mithril components are auto-wrapped with SSR rendering.
+ * API routes are registered directly as Fastify handlers.
+ */
+export async function registerRoutes(
+    server: FastifyInstance,
+    routesDir: string,
+    options: RegisterRoutesOptions = {}
+): Promise<RouteEntry[]> {
+    const routes = await scanRoutes(routesDir);
+    const mode = options.mode ?? 'development';
+    const config = options.config ?? {};
+
+    for (const route of routes) {
+        // ─── Page route with Mithril component → SSR handler ─────
+        if (route.component) {
+            const component = route.component;
+            const getServerData = route.getServerData;
+            const clientEntry = config.vite?.clientEntry ?? '/src/entry-client.ts';
+
+            server.route({
+                method: 'GET',
+                url: route.urlPath,
+                handler: async (request: FastifyRequest, reply: FastifyReply) => {
+                    // Load server data if available
+                    let initialData: Record<string, unknown> | undefined;
+                    if (getServerData) {
+                        initialData = (await getServerData(request)) as Record<string, unknown>;
+                    }
+
+                    // Dynamic import of renderer (avoids circular deps)
+                    const { renderToString } = await import('@moriajs/renderer');
+
+                    const html = await renderToString(component, {
+                        title: (component as { title?: string }).title ?? 'MoriaJS App',
+                        initialData,
+                        mode,
+                        clientEntry,
+                    });
+
+                    reply.type('text/html');
+                    return html;
+                },
+            });
+
+            server.log.info(`Page:  GET ${route.urlPath} → ${route.filePath} (SSR)`);
+            continue;
+        }
+
+        // ─── API / raw handler routes ────────────────────────────
+        for (const [method, handler] of Object.entries(route.methods)) {
+            server.route({
+                method: method.toUpperCase() as Uppercase<string>,
+                url: route.urlPath,
+                handler: handler as RouteHandler,
+            });
+            server.log.info(`Route: ${method.toUpperCase()} ${route.urlPath} → ${route.filePath}`);
+        }
+    }
+
+    server.log.info(`Registered ${routes.length} file-based route(s)`);
+    return routes;
+}

package/src/vite.ts

@@ -0,0 +1,85 @@
+/**
+ * Vite integration for MoriaJS.
+ *
+ * Provides Vite dev server in middleware mode (development)
+ * and static file serving for production builds.
+ */
+
+import type { FastifyInstance } from 'fastify';
+import type { ViteDevServer } from 'vite';
+import { type MoriaConfig } from './config.js';
+
+/**
+ * Attach Vite dev server to Fastify in middleware mode.
+ * This enables HMR and on-the-fly module transformation.
+ */
+export async function createViteDevMiddleware(
+    server: FastifyInstance,
+    config: Partial<MoriaConfig> = {}
+): Promise<ViteDevServer> {
+    const { createServer: createViteServer } = await import('vite');
+    const middie = (await import('@fastify/middie')).default;
+
+    // Register Express-style middleware support
+    await server.register(middie);
+
+    const vite = await createViteServer({
+        root: config.rootDir ?? process.cwd(),
+        configFile: config.vite?.configFile,
+        server: {
+            middlewareMode: true,
+            hmr: true,
+        },
+        appType: 'custom',
+    });
+
+    // Use Vite's connect middleware stack
+    server.use(vite.middlewares);
+
+    server.log.info('Vite dev server attached (HMR enabled)');
+
+    // Ensure Vite is closed when Fastify shuts down
+    server.addHook('onClose', async () => {
+        await vite.close();
+    });
+
+    return vite;
+}
+
+/**
+ * Serve production-built client assets via @fastify/static.
+ */
+export async function serveProductionAssets(
+    server: FastifyInstance,
+    config: Partial<MoriaConfig> = {}
+): Promise<void> {
+    const path = await import('node:path');
+    const fastifyStatic = (await import('@fastify/static')).default;
+
+    const distDir = path.resolve(config.rootDir ?? process.cwd(), 'dist', 'client');
+
+    await server.register(fastifyStatic, {
+        root: distDir,
+        prefix: '/assets/',
+        decorateReply: false,
+    });
+
+    server.log.info(`Serving static assets from ${distDir}`);
+}
+
+/**
+ * Generate the HTML shell for a page, with appropriate script tags
+ * depending on dev vs production mode.
+ */
+export function getHtmlScripts(mode: 'development' | 'production', config: Partial<MoriaConfig> = {}): string {
+    if (mode === 'development') {
+        const clientEntry = config.vite?.clientEntry ?? '/src/entry-client.ts';
+        return [
+            `<script type="module" src="/@vite/client"></script>`,
+            `<script type="module" src="${clientEntry}"></script>`,
+        ].join('\n    ');
+    }
+
+    // Production: reference the built bundle
+    return `<script type="module" src="/assets/entry-client.js"></script>`;
+}