Instalación
Crea la estructura mínima de un proyecto @ecomiq/storefront.
1. Instala las dependencias
npm install @ecomiq/storefront react react-dom
npm install --save-dev typescript @types/node @types/react @types/react-domEl paquete requiere React 19. En package.json, usa módulos ESM y agrega los
scripts de la CLI:
{
"private": true,
"type": "module",
"scripts": {
"dev": "ecomiq dev",
"build": "ecomiq build",
"deploy": "ecomiq deploy",
"clean": "ecomiq clean"
}
}2. Identifica la tienda
La CLI busca exactamente ecomiq.config.js en la raíz:
import { defineConfig } from "@ecomiq/storefront/config";
export default defineConfig({
domain: "marketplace",
});domain puede ser un slug (marketplace) o un dominio
(marketplace.ecomiq.app o marketplace.pe).
3. Crea la primera página
import { definePage } from "@ecomiq/storefront";
export default definePage({
meta: () => ({ title: "Inicio" }),
component: ({ settings }) => (
<main>
<h1>{settings.store.name}</h1>
<p>{settings.store.description}</p>
</main>
),
});4. Inicia el servidor
npm run devLa CLI genera .ecomiq/ y sirve la tienda con SSR y HMR. Añade esa carpeta a
.gitignore:
.ecomiq/La CLI no tiene un comando init o create. El proyecto debe contener
ecomiq.config.js y al menos una página .tsx o .jsx dentro de pages/.