@unsetsoft/ryunix-presets 1.0.26-canary.2 → 1.0.26-canary.20

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@unsetsoft/ryunix-presets",
   "description": "Package with presets for different development environments.",
-  "version": "1.0.26-canary.2",
+  "version": "1.0.26-canary.20",
   "author": "Neyunse",
   "type": "module",
   "repository": "https://github.com/UnSetSoft/Ryunixjs",
@@ -15,7 +15,7 @@
     "webpack/"
   ],
   "peerDependencies": {
-    "@unsetsoft/ryunixjs": "^1.2.3-canary.0 || ^1.2.2"
+    "@unsetsoft/ryunixjs": "^1.2.4-canary.0 || ^1.2.4"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org"
@@ -40,6 +40,10 @@
     "@babel/preset-react": "7.28.5",
     "@eslint/eslintrc": "3.3.3",
     "@eslint/js": "9.39.2",
+    "@mdx-js/loader": "3.1.1",
+    "@mdx-js/rollup": "3.1.1",
+    "@remark-embedder/core": "3.0.3",
+    "@remark-embedder/transformer-oembed": "5.0.1",
     "@rollup/plugin-terser": "0.4.4",
     "@swc/core": "1.15.5",
     "babel-loader": "10.0.0",
@@ -47,37 +51,32 @@
     "copy-webpack-plugin": "13.0.1",
     "css-loader": "7.1.2",
     "css-minimizer-webpack-plugin": "7.0.4",
-    "sass": "1.97.0",
-    "sass-loader": "16.0.6",
     "dotenv-webpack": "8.1.1",
     "eslint": "9.39.2",
+    "eslint-plugin-mdx": "3.6.2",
     "eslint-plugin-react": "^7.37.5",
     "eslint-webpack-plugin": "5.0.2",
-    "file-loader": "6.2.0",
     "glob": "13.0.0",
     "globals": "16.5.0",
     "html-loader": "5.1.0",
     "html-webpack-plugin": "5.6.5",
-    "lodash": "4.17.21",
     "mini-css-extract-plugin": "2.9.4",
-    "rollup": "4.53.5",
+    "postcss": "^8.5.6",
+    "postcss-loader": "^8.2.1",
+    "rehype-highlight": "7.0.2",
+    "remark-frontmatter": "5.0.0",
+    "remark-gfm": "4.0.1",
+    "remark-mdx-frontmatter": "5.2.0",
+    "rollup": "4.59.0",
+    "sass": "1.97.0",
+    "sass-loader": "16.0.6",
     "style-loader": "4.0.0",
     "terminal-log": "1.0.1",
     "terser-webpack-plugin": "5.3.16",
-    "url-loader": "4.1.1",
-    "webpack": "5.104.0",
+    "thread-loader": "4.0.4",
+    "webpack": "5.105.2",
     "webpack-cli": "6.0.1",
     "webpack-dev-server": "5.2.2",
-    "thread-loader": "4.0.4",
-    "yargs": "18.0.0",
-    "@mdx-js/loader": "3.1.1",
-    "@mdx-js/rollup": "3.1.1",
-    "eslint-plugin-mdx": "3.6.2",
-    "remark-gfm": "4.0.1",
-    "rehype-highlight": "7.0.2",
-    "remark-frontmatter": "5.0.0",
-    "remark-mdx-frontmatter": "5.2.0",
-    "@remark-embedder/core": "3.0.3",
-    "@remark-embedder/transformer-oembed": "5.0.1"
+    "yargs": "18.0.0"
   }
 }

package/webpack/bin/dev.server.mjs

@@ -7,6 +7,7 @@ import {
   getPackageVersion,
   resolveApp,
   cleanCacheDir,
+  cleanBuildDirectory,
 } from '../utils/index.mjs'
 import logger from 'terminal-log'
 import chalk from 'chalk'
@@ -53,19 +54,32 @@ const StartServer = async (cliSettings) => {
     cliSettings.production || defaultSettings.webpack.production ? true : false
 
   if (!mode) {
-    cleanCacheDir(cacheDir)
+    const buildDirectory =
+      defaultSettings.webpack.output.buildDirectory || '.ryunix'
+    await cleanCacheDir(cacheDir)
+    await cleanBuildDirectory(resolveApp(process.cwd(), join(buildDirectory, 'static')))
+    await cleanBuildDirectory(resolveApp(process.cwd(), join(buildDirectory, 'server')))
+  }
+
+  const clientConfig = Array.isArray(webpackConfig) ? webpackConfig.find(c => c.name === 'client') || webpackConfig[0] : webpackConfig
+
+  if (Array.isArray(webpackConfig)) {
+    webpackConfig.forEach(c => c.mode = mode ? 'production' : 'development')
+  } else {
+    webpackConfig.mode = mode ? 'production' : 'development'
   }
 
-  webpackConfig.mode = mode ? 'production' : 'development'
   const compiler = Webpack(webpackConfig)
-  let port = webpackConfig.devServer.port || 3000
+  let port = clientConfig.devServer?.port || 3000
 
   // Encontrar un puerto disponible
   port = await findAvailablePort(port)
 
   // Modificamos el puerto en la configuración
-  webpackConfig.devServer.port = port
-  const devServerOptions = { ...webpackConfig.devServer, ...cliSettings }
+  if (clientConfig.devServer) {
+    clientConfig.devServer.port = port
+  }
+  const devServerOptions = { ...(clientConfig.devServer || {}), ...cliSettings }
   const server = new WebpackDevServer(devServerOptions, compiler)
 
   const devMode = Boolean(!mode)

package/webpack/bin/index.mjs

@@ -1,4 +1,4 @@
-#! /usr/bin/env node
+#! /usr/bin/env node
 import yargs from 'yargs'
 import { hideBin } from 'yargs/helpers'
 import { StartDevServer } from './dev.server.mjs'
@@ -113,34 +113,69 @@ const build = {
       return
     }
 
-    if (fs.existsSync(resolveApp(process.cwd(), 'src/pages/routes.ryx'))) {
-      await cleanBuildDirectory(
-        resolveApp(
-          process.cwd(),
-          `${defaultSettings.webpack.output.buildDirectory}/static`,
-        ),
-      )
+    // ── Clean build output before each production build ───────────────────
+    // Clears static/ and server/ (except server/api/) but keeps cache/ intact.
+    const buildRoot = resolveApp(process.cwd(), defaultSettings.webpack.output.buildDirectory)
+    const clean = (dir) => {
+      if (fs.existsSync(dir)) {
+        fs.rmSync(dir, { recursive: true, force: true })
+      }
     }
+    clean(join(buildRoot, 'static'))
+    clean(join(buildRoot, 'server', 'app'))
+    clean(join(buildRoot, 'server', 'app-router-server.bundle.mjs'))
+    // Note: server/api/ is cleaned by ApiRouterPlugin on its own (incremental recompile)
+
+    const buildStart = Date.now()
 
     compiler.run(async (err, stats) => {
       if (err || stats.hasErrors()) {
-        logger.error(chalk.red('Error during compilation:'))
-        logger.error(err || stats.toString('errors-only'))
+        logger.error(chalk.red('✘ Error during compilation:'))
+        if (err) {
+          logger.error(err)
+        } else {
+          // MultiStats or Stats — toString works on both
+          const output = stats.toString('errors-only')
+          const lines = output.split('\n').filter(Boolean)
+          lines.forEach((line) => logger.error(line))
+        }
+        compiler.close(() => process.exit(1))
         return
       }
 
-      const buildTimeMs = stats.endTime - stats.startTime
-
+      // ── Build time ─────────────────────────────────────────────────────────
+      const buildTimeMs = Date.now() - buildStart
       const minutes = Math.floor(buildTimeMs / 60000)
       const seconds = ((buildTimeMs % 60000) / 1000).toFixed(1)
+      const formattedTime = minutes > 0 ? `${minutes}m ${seconds}s` : `${seconds}s`
 
-      const formattedTime =
-        minutes > 0 ? `${minutes}m ${seconds}s` : `${seconds}s`
-
+      // ── SSG Prerender ──────────────────────────────────────────────────────
       if (defaultSettings.webpack.production) {
         await Prerender(defaultSettings.webpack.output.buildDirectory)
       }
 
+      // ── API Routes log ─────────────────────────────────────────────────────
+      const apiOutputDir = join(buildRoot, 'server', 'api')
+      if (fs.existsSync(apiOutputDir)) {
+        const collectRoutes = (dir, base = '') => {
+          const routes = []
+          for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+            const fullPath = join(dir, entry.name)
+            if (entry.isDirectory()) {
+              routes.push(...collectRoutes(fullPath, `${base}/${entry.name}`))
+            } else if (/^(route|router|endpoint)\.(mjs|js)$/.test(entry.name)) {
+              routes.push(base || '/')
+            }
+          }
+          return routes
+        }
+        const apiRoutes = collectRoutes(apiOutputDir)
+        if (apiRoutes.length > 0) {
+          console.log(`✅ API routes (${apiRoutes.length}):`)
+          apiRoutes.forEach((r) => console.log(` - /api${r}`))
+        }
+      }
+
       logger.info(chalk.green('Compilation successful! 🎉'))
       logger.info(`Done in ${formattedTime}`)
 
@@ -148,6 +183,7 @@ const build = {
         if (closeErr) {
           logger.error(chalk.red('Error closing the compiler:'), closeErr)
         }
+        process.exit(0)
       })
     })
   },

package/webpack/bin/prerender.mjs

@@ -16,7 +16,7 @@ const Prerender = async (directory) => {
     process.exit(1)
   }
 
-  const manifestPath = path.join(process.cwd(), directory, 'ssg', 'routes.json')
+  const manifestPath = path.join(process.cwd(), directory, 'cache/ssg', 'routes.json')
   let routes = []
 
   if (fs.existsSync(manifestPath)) {

package/webpack/bin/prod.server.mjs

@@ -379,7 +379,7 @@ const requestHandler = async (req, res) => {
     const pathname = decodeURIComponent(parsedUrl.pathname)
 
     // Check for API Request
-    const apiRootPath = path.join(rootDir, config.webpack.output.buildDirectory, 'api')
+    const apiRootPath = path.join(rootDir, config.webpack.output.buildDirectory, 'server/api')
     const handledApi = await handleApiRequest(req, res, apiRootPath)
     if (handledApi) return
 

package/webpack/template/index.html

@@ -13,7 +13,8 @@
     <title><%= htmlWebpackPlugin.options.title %></title>
   </head>
   <body>
-    <noscript>You need to enable JavaScript to run this app.</noscript>
+    <%= htmlWebpackPlugin.options.ssrScript %>
+
     <div id="__ryunix"></div>
   </body>
 </html>

package/webpack/utils/ApiRouterPlugin.mjs

@@ -5,12 +5,12 @@ import { transformSync } from '@swc/core'
 /**
  * Valid API route file names
  */
-const API_FILE_NAMES = ['route.js', 'route.ryx', 'endpoint.js']
+const API_FILE_NAMES = ['route.js', 'route.ts', 'route.ryx', 'router.js', 'router.ts', 'router.ryx', 'endpoint.js', 'endpoint.ts']
 
 class ApiRouterPlugin {
   constructor(options = {}) {
     this.appDir = options.appDir || 'src/app'
-    this.outputPath = options.outputPath || '.ryunix/api'
+    this.outputPath = options.outputPath || '.ryunix/server/api'
     this.debug = options.debug || false
   }
 
@@ -40,13 +40,7 @@ class ApiRouterPlugin {
       }
 
       try {
-        const stats = fs.statSync(apiDirPath)
-        const mtime = stats.mtimeMs
-
-        if (mtime > lastScanTime) {
-          this.compileApiRoutes(apiDirPath, path.resolve(process.cwd(), this.outputPath))
-          lastScanTime = mtime
-        }
+        this.compileApiRoutes(apiDirPath, path.resolve(process.cwd(), this.outputPath))
       } catch (error) {
         console.error('[ApiRouter] ❌ ERROR compiling api routes:', error)
       }
@@ -92,6 +86,28 @@ class ApiRouterPlugin {
 
   compileFile(sourcePath, currentOutDir, fileName) {
     try {
+      // Always output as .mjs for native Node ESM support
+      const outFileName = fileName.replace(/\.(ts|ryx|js)$/, '.mjs')
+      const outFilePath = path.join(currentOutDir, outFileName)
+
+      // Get stats for both files
+      const sourceStats = fs.statSync(sourcePath)
+      const sourceMtime = sourceStats.mtimeMs
+
+      let shouldCompile = true
+      if (fs.existsSync(outFilePath)) {
+        const outStats = fs.statSync(outFilePath)
+        const outMtime = outStats.mtimeMs
+        // If the output file is newer than the source file, skip compilation
+        if (outMtime > sourceMtime) {
+          shouldCompile = false
+        }
+      }
+
+      if (!shouldCompile) {
+        return
+      }
+
       const content = fs.readFileSync(sourcePath, 'utf8')
       const isTs = fileName.endsWith('.ts')
       const isRyx = fileName.endsWith('.ryx')
@@ -116,21 +132,8 @@ class ApiRouterPlugin {
         }
       })
 
-      // Always output as .mjs for native Node ESM support
-      const outFileName = fileName.replace(/\.(ts|ryx|js)$/, '.mjs')
-      const outFilePath = path.join(currentOutDir, outFileName)
-
-      // Only write if changed to avoid unnecessary reloads
-      let shouldWrite = true
-      if (fs.existsSync(outFilePath)) {
-        const existing = fs.readFileSync(outFilePath, 'utf8')
-        if (existing === code) shouldWrite = false
-      }
-
-      if (shouldWrite) {
-        if (this.debug) console.log(`[ApiRouter] Compiled: ${sourcePath} -> ${outFilePath}`)
-        fs.writeFileSync(outFilePath, code)
-      }
+      if (this.debug) console.log(`[ApiRouter] Compiled: ${sourcePath} -> ${outFilePath}`)
+      fs.writeFileSync(outFilePath, code)
     } catch (e) {
       console.error(`[ApiRouter] Error compiling ${sourcePath}:`, e.message)
     }

package/webpack/utils/appRouterPlugin.mjs

@@ -4,7 +4,8 @@ import path from 'path';
 class AppRouterPlugin {
   constructor(options = {}) {
     this.appDir = options.appDir || 'src/app';
-    this.outputPath = options.outputPath || '.ryunix/app-router.js';
+    this.outputPath = options.outputPath || '.ryunix/server/app/app-router.js';
+    this.ssgOutputPath = options.ssgOutputPath || null; // explicit path for routes.json
     this.debug = options.debug || false;
   }
 
@@ -65,7 +66,7 @@ class AppRouterPlugin {
     for (const entry of entries) {
       if (entry.isFile()) {
         const ext = path.extname(entry.name);
-        if (!['.ryx', '.js', '.jsx'].includes(ext)) continue;
+        if (!['.ryx', '.js', '.jsx', '.ts', '.tsx', '.mdx'].includes(ext)) continue;
 
         const name = path.basename(entry.name, ext);
         const fullPath = path.join(dir, entry.name).replace(/\\/g, '/');
@@ -112,7 +113,36 @@ class AppRouterPlugin {
     const extractMeta = (filePath) => {
       if (!filePath) return null;
       try {
-        const content = fs.readFileSync(filePath, 'utf8');
+        let content = fs.readFileSync(filePath, 'utf8');
+
+        // Remove BOM if present
+        if (content.charCodeAt(0) === 0xFEFF) content = content.slice(1);
+        content = content.replace(/\r\n/g, '\n');
+
+        // Check for MDX YAML frontmatter
+        if (filePath.endsWith('.mdx')) {
+          const mdxMatch = content.match(/^---\s*\n([\s\S]*?)\n\s*---/);
+          if (mdxMatch) {
+            const yamlContent = mdxMatch[1];
+            const frontmatter = {};
+            const lines = yamlContent.split('\n').filter(line => line.trim());
+
+            for (const line of lines) {
+              const keyValueMatch = line.match(/^\s*(\w+)\s*:\s*(.+)$/);
+              if (keyValueMatch) {
+                const key = keyValueMatch[1].trim();
+                let value = keyValueMatch[2].trim();
+                if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+                  value = value.slice(1, -1);
+                }
+                frontmatter[key] = value;
+              }
+            }
+            // Title and description are the standard keys in YAML used for metatags
+            if (Object.keys(frontmatter).length > 0) return frontmatter;
+          }
+        }
+
         const metatagMatch = content.match(/export\s+const\s+Metatags?\s*=\s*(\{[\s\S]*?\})(?=\s*(?:export|;|$))/);
         if (metatagMatch) {
           return new Function(`return ${metatagMatch[1]}`)();
@@ -125,10 +155,32 @@ class AppRouterPlugin {
 
     const layoutMeta = extractMeta(layout) || {};
     const indexMeta = extractMeta(index) || {};
-    let meta = null;
+    let meta = {};
+
+    const mergeMeta = (target, source) => {
+      if (!source) return;
+      Object.keys(source).forEach(key => {
+        if (key === 'title') {
+          if (typeof source.title === 'object') {
+            target.titleTemplate = source.title.template || target.titleTemplate;
+            target.titleDefault = source.title.default || target.titleDefault;
+            target.title = source.title.default || target.title;
+          } else {
+            target.title = source.title;
+          }
+        } else {
+          target[key] = source[key];
+        }
+      });
+    };
+
+    mergeMeta(meta, layoutMeta);
+    mergeMeta(meta, indexMeta);
+
+
 
-    if (Object.keys(layoutMeta).length > 0 || Object.keys(indexMeta).length > 0) {
-      meta = { ...layoutMeta, ...indexMeta };
+    if (Object.keys(meta).length === 0) {
+      meta = null;
     }
 
     if (!layout && !index && children.length === 0 && !errorFile && !loadingFile) {
@@ -139,7 +191,14 @@ class AppRouterPlugin {
       if (!filePath) return false;
       try {
         const content = fs.readFileSync(filePath, 'utf8');
-        return content.includes('async function') || content.includes('async (');
+        // Improved detection: look for async exports or async function declarations outside comments/strings
+        // This is still a heuristic but more targeted towards Ryunix components
+        return (
+          /export\s+default\s+async\s+/.test(content) ||
+          /export\s+const\s+Metatags\s*=\s*async/.test(content) ||
+          /export\s+const\s+DynamicMetadata\s*=\s*async/.test(content) ||
+          (/async\s+function/.test(content) && content.includes('export default'))
+        );
       } catch (e) {
         return false;
       }
@@ -188,15 +247,38 @@ class AppRouterPlugin {
       importStatements += `import * as ${errorsId} from '${this.getRelativeImport(errorsPath, outputPath)}';\n`;
     }
 
-    const traverse = (node, parentLayouts = []) => {
+    const mergeStaticMeta = (target, source) => {
+      if (!source) return;
+      Object.keys(source).forEach(key => {
+        if (key === 'title') {
+          if (typeof source.title === 'object') {
+            target.titleTemplate = source.title.template || target.titleTemplate;
+            target.titleDefault = source.title.default || target.titleDefault;
+            target.title = source.title.default || target.title;
+          } else {
+            target.title = source.title;
+          }
+        } else {
+          target[key] = source[key];
+        }
+      });
+    };
+
+    const traverse = (node, parentLayouts = [], inheritedMeta = {}) => {
       if (Array.isArray(node)) {
         for (const child of node) {
-          traverse(child, parentLayouts);
+          traverse(child, parentLayouts, inheritedMeta);
         }
         return;
       }
 
       const currentLayouts = [...parentLayouts];
+      const currentMeta = { ...inheritedMeta };
+      if (node.meta) Object.assign(currentMeta, JSON.parse(JSON.stringify(node.meta))); // deep clone workaround
+
+      if (node.meta) {
+        mergeStaticMeta(currentMeta, node.meta);
+      }
       if (node.layout) {
         const layoutId = `Layout_${getNextId()}`;
         importStatements += `import * as ${layoutId} from '${this.getRelativeImport(node.layout, outputPath)}';\n`;
@@ -210,8 +292,8 @@ class AppRouterPlugin {
         const indexId = `Index_${getNextId()}`;
         importStatements += `import * as ${indexId} from '${this.getRelativeImport(node.index, outputPath)}';\n`;
 
-        const layoutsArrayStr = `[${currentLayouts.map(l => `{ default: getOptExport(${l.id}, 'default'), isAsync: ${l.isAsync} }`).join(', ')}]`;
-        const indexConfigStr = `{ default: getOptExport(${indexId}, 'default'), isAsync: ${!!node.indexIsAsync}, Metatags: getOptExport(${indexId}, 'Metatags') || {} }`;
+        const layoutsArrayStr = `[${currentLayouts.map(l => `{ default: getOptExport(${l.id}, 'default'), isAsync: ${l.isAsync}, Metatags: getOptExport(${l.id}, 'Metatags') || getOptExport(${l.id}, 'frontmatter') || {} }`).join(', ')}]`;
+        const indexConfigStr = `{ default: getOptExport(${indexId}, 'default'), isAsync: ${!!node.indexIsAsync}, Metatags: getOptExport(${indexId}, 'Metatags') || getOptExport(${indexId}, 'frontmatter') || {} }`;
         const errorPropStr = errorsId ? `Object.assign(${indexConfigStr}, { errorComponent: getOptExport(${errorsId}, 'UnknownError') || getOptExport(${errorsId}, 'UnknowError') || getOptExport(${errorsId}, 'default') })` : indexConfigStr;
 
         let componentBody = `<RouteWrapper layouts={${layoutsArrayStr}} index={${errorPropStr}} props={props} />`;
@@ -222,15 +304,22 @@ class AppRouterPlugin {
     component: (props) => ${componentBody}
   }`);
 
+        const finalMeta = { ...currentMeta };
+        if (finalMeta.titleTemplate && finalMeta.title && finalMeta.title !== finalMeta.titleDefault) {
+          finalMeta.title = finalMeta.titleTemplate.replace('%s', finalMeta.title);
+        } else if (finalMeta.titleDefault && !finalMeta.title) {
+          finalMeta.title = finalMeta.titleDefault;
+        }
+
         ssgRoutes.push({
           path: node.path,
-          meta: node.meta || {}
+          meta: Object.keys(finalMeta).length > 0 ? finalMeta : {}
         });
       }
 
       if (Array.isArray(node.children)) {
         for (const child of node.children) {
-          traverse(child, currentLayouts);
+          traverse(child, currentLayouts, currentMeta);
         }
       }
     };
@@ -240,12 +329,12 @@ class AppRouterPlugin {
     }
 
     if (errorsPath) {
-      const layoutsArrayStr = `[${rootLayouts.map(l => `{ default: ${l.id}.default, isAsync: ${l.isAsync} }`).join(', ')}]`;
+      const layoutsArrayStr = `[${rootLayouts.map(l => `{ default: getOptExport(${l.id}, 'default'), isAsync: ${l.isAsync}, Metatags: getOptExport(${l.id}, 'Metatags') || getOptExport(${l.id}, 'frontmatter') || {} }`).join(', ')}]`;
       flattenedRoutes.push(`
   {
     path: '*',
-    NotFound: (props) => <RouteWrapper layouts={${layoutsArrayStr}} index={{ default: getOptExport(${errorsId}, 'NotFound') || getOptExport(${errorsId}, 'default'), isAsync: false, Metatags: getOptExport(${errorsId}, 'Metatags') || {} }} props={props} />,
-    ErrorBuild: (props) => <RouteWrapper layouts={${layoutsArrayStr}} index={{ default: getOptExport(${errorsId}, 'ErrorBuild') || getOptExport(${errorsId}, 'default'), isAsync: false, Metatags: getOptExport(${errorsId}, 'Metatags') || {} }} props={props} />
+    NotFound: (props) => <RouteWrapper layouts={${layoutsArrayStr}} index={{ default: getOptExport(${errorsId}, 'NotFound') || getOptExport(${errorsId}, 'default'), isAsync: false, Metatags: getOptExport(${errorsId}, 'Metatags') || getOptExport(${errorsId}, 'frontmatter') || {} }} props={props} />,
+    ErrorBuild: (props) => <RouteWrapper layouts={${layoutsArrayStr}} index={{ default: getOptExport(${errorsId}, 'ErrorBuild') || getOptExport(${errorsId}, 'default'), isAsync: false, Metatags: getOptExport(${errorsId}, 'Metatags') || getOptExport(${errorsId}, 'frontmatter') || {} }} props={props} />
   }`);
     }
 
@@ -273,7 +362,7 @@ const AsyncComponentRenderer = ({ Component, componentProps, ErrorFallback }) =>
     };
     run();
     return () => { active = false; };
-  }, []); // Only run once on mount
+  }, [Component, JSON.stringify(componentProps)]); // Update when component or props change
 
   return content;
 };
@@ -443,7 +532,7 @@ export default function AppRouter() {
     const mainEntryPath = path.join(path.dirname(outputPath), 'main.ryx');
     const mainEntryContent = `import Ryunix from '@unsetsoft/ryunixjs';
 import AppRouter from './${path.basename(outputPath)}';
-
+ 
 Ryunix.init(<AppRouter />);
 `;
     let shouldWriteMain = true;
@@ -458,8 +547,28 @@ Ryunix.init(<AppRouter />);
       if (this.debug) console.log(`[AppRouter] Generating main entry at ${mainEntryPath}`);
     }
 
+    // Server Entry for SSG/SSR
+    const serverEntryPath = path.join(path.dirname(outputPath), 'app-router-server.js');
+    const serverEntryContent = `import AppRouter from './${path.basename(outputPath)}';
+export const ssgRoutes = ${JSON.stringify(ssgRoutes, null, 2)};
+export default AppRouter;
+`;
+    let shouldWriteServer = true;
+    if (fs.existsSync(serverEntryPath)) {
+      const existingServerContent = fs.readFileSync(serverEntryPath, 'utf8');
+      if (existingServerContent === serverEntryContent) {
+        shouldWriteServer = false;
+      }
+    }
+    if (shouldWriteServer) {
+      fs.writeFileSync(serverEntryPath, serverEntryContent);
+      if (this.debug) console.log(`[AppRouter] Generating server entry at ${serverEntryPath}`);
+    }
+
     // SSG Output
-    const ssgManifestPath = path.join(path.dirname(outputPath), 'ssg', 'routes.json');
+    const ssgManifestPath = this.ssgOutputPath
+      ? path.resolve(process.cwd(), this.ssgOutputPath)
+      : path.join(path.dirname(outputPath), 'ssg', 'routes.json');
     const ssgManifestContent = JSON.stringify(ssgRoutes, null, 2);
 
     let shouldWriteSsg = true;

package/webpack/utils/config.cjs

@@ -4,6 +4,38 @@ const reactPlugin = require('eslint-plugin-react')
 
 const userConfig = getConfig()
 
+const path = require('path')
+const fs = require('fs')
+
+/**
+ * Check if a config path exists in userConfig and warn if it's deprecated.
+ */
+const warnDeprecated = (configPath, message) => {
+  if (!userConfig) return
+
+  const keys = configPath.split('.')
+  let value = userConfig
+  for (const key of keys) {
+    if (value?.[key] === undefined) return
+    value = value[key]
+  }
+  if (value !== undefined) {
+    console.warn(`\x1b[33m[Ryunix Warn]\x1b[0m \x1b[1m${configPath}\x1b[0m is deprecated. ${message}`)
+  }
+}
+
+// Check for App Router presence
+const rootDir = userConfig?.webpack?.root ?? 'src'
+const hasAppDir = fs.existsSync(path.resolve(process.cwd(), 'app')) || fs.existsSync(path.resolve(process.cwd(), `${rootDir}/app`))
+
+// Global old SSG deprecations
+warnDeprecated('experimental.ssg', 'The old SSG configuration is deprecated and will be removed in future versions in favor of App Router SSG conventions.')
+
+// App Router specific deprecations
+if (hasAppDir) {
+  warnDeprecated('static.seo', 'The global static.seo configuration is redundant when using the App Router. Use exported metadata in layout.ryx/page.ryx instead.')
+  warnDeprecated('static.customTemplate', 'Custom templates are replaced by the root layout.ryx when using the App Router.')
+}
 // ============================================================================
 // Helpers
 // ============================================================================
@@ -74,6 +106,7 @@ const DEFAULT_SSG_SITEMAP_SETTINGS = {
 const defaultSettings = {
   experimental: {
     mdx: getConfigValue('experimental.mdx', false),
+    ssr: getConfigValue('experimental.ssr', false),
 
     ssg: {
       sitemap: {