meeko init

meeko init crea el starter del motor de componentes: una página renderizada en el servidor e hidratada en el navegador, sin rutas por archivos, sin meeko.config.ts y sin app/ ni server/. Es el punto de partida para usar componentes .meeko dentro de un servidor propio o para aprender cómo funcionan SSR e hidratación sin el framework. Para una aplicación completa, usa meeko init-framework.

No instala dependencias ni sobrescribe archivos: escribe el proyecto y dice el siguiente paso.

Uso#

npx @meekojs/meeko init mi-app

Proyecto creado en C:\proyectos\mi-app
Siguiente paso: cd C:\proyectos\mi-app && npm install && npm run dev

Tipo#

meeko init <directorio>

Parámetros#

Resultado#

mi-app/
├── .gitignore          node_modules/, dist/, .meeko/
├── README.md
├── index.html
├── package.json
├── server.mjs          servidor de Node: Vite en desarrollo, dist/ con --production
├── tsconfig.json       con allowArbitraryExtensions y rootDirs sobre .meeko/types
├── vite.config.ts      plugins: [meeko()]
└── src/
    ├── App.meeko       un contador con props y una señal
    ├── entry-client.ts hidrata con las props y el estado del servidor
    └── entry-server.ts renderiza con renderWithState

package.json fija @meekojs/meeko a la versión exacta que creó el proyecto (el código compilado y el runtime deben coincidir), añade @types/node, typescript y vite y declara estos scripts:

El mensaje dice pnpm en lugar de npm si la carpeta ya tenía pnpm-lock.yaml. Si el directorio es el actual, omite el cd.

Ejemplos#

Un proyecto nuevo#

npx @meekojs/meeko init contador
cd contador
npm install
npm run dev
# http://localhost:4173

En la carpeta actual, con el paquete ya instalado#

mkdir contador && cd contador
pnpm add @meekojs/meeko
pnpm exec meeko init .
pnpm install
pnpm run dev

package.json, pnpm-lock.yaml y node_modules se conservan: init añade sus scripts y dependencias al package.json existente.

Comprobar y construir#

npm run check   # genera .meeko/types/src/App.d.meeko.ts y ejecuta tsc
npm run build   # dist/client y dist/server
npm start       # sirve dist/ con SSR en 127.0.0.1:4173

MEEKO_PORT (o PORT) cambia el puerto de server.mjs; la dirección es siempre 127.0.0.1, y se cambia editando server.mjs, que ya es código del proyecto.

Errores comunes#

Una carpeta con archivos#

meeko init mi-app   # mi-app ya tiene src/ e index.html

El destino no está vacío: C:\proyectos\mi-app (.gitignore, index.html, README.md, server.mjs, src, tsconfig.json, vite.config.ts)

La lista son las entradas que impiden crear el proyecto; nada se escribe. Una carpeta con sólo .git se acepta desde 1.7; con lockfiles o node_modules pero sin package.json, el mensaje termina en (sin package.json). Los mensajes están en español desde 1.7.

meeko init mi-app-nueva

Un package.json con otros scripts o dependencias#

# package.json con "scripts": { "dev": "vite" } o con "dependencies": { "react": "…" }
meeko init .

El destino ya define el script dev: C:\proyectos\mi-app o El destino tiene otras dependencias: C:\proyectos\mi-app. El starter sólo se combina con un package.json recién creado.

npm init -y && meeko init .

Olvidar el directorio#

meeko init

Falta el directorio de init, con el uso y código 1.

meeko init .

Notas#

• Motor, no framework. El starter no tiene rutas, layouts, API, sesiones ni meeko dev: server.mjs es un servidor de ejemplo que renderiza / con renderWithState y sirve los assets. Todo lo demás lo decide el proyecto.
• Tipos. meeko types src/App.meeko escribe las declaraciones de los componentes en .meeko/types/, y el tsconfig.json las superpone a src/ con rootDirs; por eso check lo ejecuta antes de tsc.
• Cierre. server.mjs cierra HTTP y Vite con SIGINT y SIGTERM, conserva las dos causas si ambos fallan y sale con un código de error.
• Windows y POSIX. Los scripts usan node y vite sin sintaxis de shell, así que funcionan igual en PowerShell, cmd y POSIX.
• Node 24. El package.json declara "engines": { "node": ">=24" }.

Relacionado#

• meeko init-frameworkCrea una aplicación full-stack de Meeko con meeko.config.ts, app/, un layout, una página prerenderizada, .env.example y los scripts de la CLI.
• meeko typesGenera en .meeko/types/ la declaración .d.meeko.ts de un componente y de los componentes que importa, para que TypeScript compruebe sus props.
• meeko compileComprueba un componente .meeko y lo compila a un módulo TypeScript con su render de servidor, su hidratación y sus tipos.
• meeko (Vite)Plugin de Vite de Meeko, que compila los imports .meeko en cliente y SSR, añade HMR y CSS en desarrollo, aplica los autoimports y genera los módulos virtuales del framework.
• HerramientasAPI de Meeko
• Crear una aplicaciónMeeko como framework full-stack