raiko.js 1.0.2 → 1.0.3

package/README.es.md

@@ -21,21 +21,53 @@
 
 </div>
 
-## Empieza con un solo comando
+## Empieza con un comando
+
+**1. Crea el proyecto.** El instalador pregunta lo que quieres (frontend, CSS, base de datos, login, email, deploy) y escribe una app que ya funciona.
 
 ```bash
 npx create-raiko@latest my-app
-# or
+# o
 bun create raiko my-app
 ```
 
-El instalador te pregunta qué necesitas y genera un proyecto que ya funciona: frontend (Raiko Pages con Voodoo.js, React, Vue, Svelte, Solid, Preact o Angular), CSS (Monsoon, Tailwind, StyleX, UnoCSS), íconos, base de datos (Kastor, Prisma o Drizzle sobre SQLite o PostgreSQL), inicio de sesión (correo y contraseña, GitHub, Google, Discord, GitLab), autenticación de dos factores, proveedor de correo, traducciones, roles de administración, un banner de cookies, una app instalable y un destino de despliegue. Cada combinación se instala, se verifica con el chequeo de tipos, se compila y se arranca en CI.
+Usa las flechas para moverte, Enter para elegir, Espacio para marcar elementos de una lista y Esc para volver a la pregunta anterior.
+
+**2. Arranca el servidor de desarrollo.**
 
 ```bash
 cd my-app
-npm run dev
+npm run dev        # o: bun run dev
+```
+
+**3. Abre la dirección que muestra la terminal.**
+
+```
+  raiko.js 1.0.3 dev
+
+  - Local:    http://localhost:3000
+  - Network:  http://192.168.0.10:3000
+
+  ready in 240 ms  (save a file to reload)
 ```
 
+| Elegiste | Abre | Qué corre ahí |
+| --- | --- | --- |
+| Raiko Pages (por defecto) | http://localhost:3000 | páginas, API, sockets y admin en un solo servidor |
+| React, Vue, Svelte, Solid, Preact o Angular | http://localhost:5173 | Vite, con el backend de Raiko dentro en el mismo puerto |
+
+Verás la página inicial con los siguientes pasos. Edita el archivo que indica (`app/page.tsx`, o `web/src/App.tsx` en las plantillas con Vite), guarda y la página se recarga.
+
+Direcciones útiles en una app nueva: `/api/hello` (una ruta de API), `/docs` (documentación de la API generada desde tus esquemas), `/health` y, si los elegiste, `/admin`, `/login` y `/_raiko/mail` (vista previa de emails).
+
+**Abrir en el celular.** Usa la dirección Network con el celular en el mismo Wi-Fi.
+
+**Usar otro puerto.** `PORT=4000 npm run dev` (Raiko Pages) o `npm run dev -- --port 4000` (plantillas con Vite).
+
+**Puerto ocupado.** Verás `error[RK0706]: port 3000 is already in use`. Detén el otro servidor o usa otro puerto como arriba.
+
+**Producción.** `npm run build` y luego `npm run start` sirven la misma app con `NODE_ENV=production`, en el puerto de `PORT` (3000 por defecto).
+
 ## El recorrido de 30 segundos
 
 Una API con validación, tipos y documentación OpenAPI a partir de un solo esquema:

package/README.md

@@ -23,19 +23,51 @@
 
 ## Start in one command
 
+**1. Create the project.** The installer asks what you want (frontend, CSS, database, sign in, email, deploy) and writes an app that already works.
+
 ```bash
 npx create-raiko@latest my-app
 # or
 bun create raiko my-app
 ```
 
-The installer asks what you want and writes a project that already works: frontend (Raiko Pages with Voodoo.js, React, Vue, Svelte, Solid, Preact or Angular), CSS (Monsoon, Tailwind, StyleX, UnoCSS), icons, database (Kastor, Prisma or Drizzle on SQLite or PostgreSQL), sign in (email and password, GitHub, Google, Discord, GitLab), two factor auth, email provider, translations, admin roles, a cookie banner, an installable app, and a deploy target. Every combination is installed, type checked, built and booted in CI.
+Use the arrow keys to move, Enter to choose, Space to mark items in a list, and Esc to go back to the previous question.
+
+**2. Start the dev server.**
 
 ```bash
 cd my-app
-npm run dev
+npm run dev        # or: bun run dev
+```
+
+**3. Open the address the terminal prints.**
+
+```
+  raiko.js 1.0.3 dev
+
+  - Local:    http://localhost:3000
+  - Network:  http://192.168.0.10:3000
+
+  ready in 240 ms  (save a file to reload)
 ```
 
+| You picked | Open | What runs there |
+| --- | --- | --- |
+| Raiko Pages (the default) | http://localhost:3000 | pages, API, sockets, admin, one server |
+| React, Vue, Svelte, Solid, Preact or Angular | http://localhost:5173 | Vite, with the Raiko backend inside it on the same port |
+
+You will see the starter page with the next steps. Edit the file it names (`app/page.tsx`, or `web/src/App.tsx` for Vite templates), save, and the page reloads.
+
+Useful addresses in a new app: `/api/hello` (an API route), `/docs` (API docs generated from your schemas), `/health`, and, when you picked them, `/admin`, `/login` and `/_raiko/mail` (email previews).
+
+**Open it on your phone.** Use the Network address while the phone is on the same Wi-Fi.
+
+**Use another port.** `PORT=4000 npm run dev` (Raiko Pages) or `npm run dev -- --port 4000` (Vite templates).
+
+**Port already in use.** You will see `error[RK0706]: port 3000 is already in use`. Stop the other server or pick another port as above.
+
+**Production.** `npm run build` then `npm run start` serves the same app with `NODE_ENV=production`, on the port in `PORT` (3000 by default).
+
 ## The 30 second tour
 
 An API with validation, types and OpenAPI docs from one schema:

package/README.pt-BR.md

@@ -23,19 +23,51 @@
 
 ## Comece com um comando
 
+**1. Crie o projeto.** O instalador pergunta o que você quer (frontend, CSS, banco, login, e-mail, deploy) e escreve um app que já funciona.
+
 ```bash
 npx create-raiko@latest my-app
-# or
+# ou
 bun create raiko my-app
 ```
 
-O instalador pergunta o que você quer e gera um projeto que já funciona: frontend (Raiko Pages com Voodoo.js, React, Vue, Svelte, Solid, Preact ou Angular), CSS (Monsoon, Tailwind, StyleX, UnoCSS), ícones, banco de dados (Kastor, Prisma ou Drizzle sobre SQLite ou PostgreSQL), login (email e senha, GitHub, Google, Discord, GitLab), autenticação em dois fatores, provedor de email, traduções, papéis de admin, banner de cookies, app instalável e destino de deploy. Toda combinação é instalada, checada nos tipos, compilada e executada no CI.
+Use as setas para mover, Enter para escolher, Espaço para marcar itens numa lista e Esc para voltar à pergunta anterior.
+
+**2. Suba o servidor de desenvolvimento.**
 
 ```bash
 cd my-app
-npm run dev
+npm run dev        # ou: bun run dev
+```
+
+**3. Abra o endereço que o terminal mostra.**
+
+```
+  raiko.js 1.0.3 dev
+
+  - Local:    http://localhost:3000
+  - Network:  http://192.168.0.10:3000
+
+  ready in 240 ms  (save a file to reload)
 ```
 
+| Você escolheu | Abra | O que roda ali |
+| --- | --- | --- |
+| Raiko Pages (o padrão) | http://localhost:3000 | páginas, API, sockets e admin num servidor só |
+| React, Vue, Svelte, Solid, Preact ou Angular | http://localhost:5173 | o Vite, com o backend do Raiko dentro dele na mesma porta |
+
+Você verá a página inicial com os próximos passos. Edite o arquivo que ela indica (`app/page.tsx`, ou `web/src/App.tsx` nos templates com Vite), salve e a página recarrega.
+
+Endereços úteis num app novo: `/api/hello` (uma rota de API), `/docs` (documentação da API gerada pelos seus schemas), `/health` e, se você escolheu, `/admin`, `/login` e `/_raiko/mail` (prévia dos e-mails).
+
+**Abrir no celular.** Use o endereço Network com o celular no mesmo Wi-Fi.
+
+**Usar outra porta.** `PORT=4000 npm run dev` (Raiko Pages) ou `npm run dev -- --port 4000` (templates com Vite).
+
+**Porta ocupada.** Aparece `error[RK0706]: port 3000 is already in use`. Pare o outro servidor ou use outra porta como acima.
+
+**Produção.** `npm run build` e depois `npm run start` sobem o mesmo app com `NODE_ENV=production`, na porta de `PORT` (3000 por padrão).
+
 ## O tour de 30 segundos
 
 Uma API com validação, tipos e documentação OpenAPI a partir de um único schema:

package/dist/app-router/index.js

@@ -233,8 +233,13 @@ async function appRouter(options = {}) {
     app.onBeforeHandle((ctx) => matcher && !matcher.test(unprefixed(ctx.path)) ? void 0 : mw.default(ctx), "global");
     break;
   }
-  const publicDir = options.publicDir === void 0 && manifest ? null : resolve(options.publicDir ?? "public");
-  if (publicDir && existsSync(publicDir)) {
+  const publicDir = resolve(options.publicDir ?? "public");
+  let hasPublic = false;
+  try {
+    hasPublic = existsSync(publicDir);
+  } catch {
+  }
+  if (hasPublic) {
     const { staticFiles } = await import('../static-7FVGQ2UM.js');
     app.use(staticFiles({ dir: publicDir, prefix: "/" }));
     const { imageHandler } = await import('../image-FBZPWI2W.js');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "raiko.js",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "The full stack TypeScript framework: Next.js style app router, server components, typed API, WebSockets with encryption, auth, admin and email. Runs on Bun, Node, Deno, Cloudflare Workers and Vercel.",
   "type": "module",
   "license": "MIT",