CLI
Scaffoldea un nuevo proyecto de Arcton con arcton create y sus dos templates de runtime.
Resumen
Scaffoldea un nuevo proyecto de forma interactiva:
bunx arcton create my-appo mediante la convención de scaffolding del package manager, que resuelve al mismo flujo a través del paquete separado create-arcton:
bun create arcton my-app
npm create arcton my-app
pnpm create arcton my-appPasar el nombre como argumento (como arriba) se salta el prompt del nombre; corriéndolo sin uno lo pregunta interactivamente.
arcton create
Propósito — scaffoldea interactivamente un nuevo proyecto de Arcton: elegir un nombre de proyecto, un runtime, y un package manager, y luego opcionalmente instalar las dependencias.
Firma
arcton create [name]Parámetros
| Parámetro | Tipo | Descripción |
|---|---|---|
name | string (opcional) | Nombre del directorio del proyecto. Debe contener solo letras, dígitos, puntos, guiones y guiones bajos. Se pregunta interactivamente si se omite. |
Comportamiento — el flujo, en orden:
- Pregunta por un nombre de proyecto (se salta si se pasó como argumento).
- Pregunta por un runtime: Bun o Node.js.
- Pregunta por un package manager:
bun,pnpm, onpm(por defectobunsi el runtime elegido es Bun, si nonpm). - Si el directorio destino ya existe y no está vacío, pide confirmar si sobrescribirlo.
- Copia el template del runtime elegido al directorio destino y setea el
namedel proyecto en supackage.json. - Pregunta si instalar las dependencias ahora (por defecto sí), y corre el comando de instalación correspondiente si la respuesta es afirmativa.
- Imprime los próximos pasos a seguir.
Esto se expone tanto como el subcomando arcton create (desde el subpath export arcton/create del paquete arcton) como, de forma independiente, create-arcton — un paquete cuyo único trabajo es satisfacer la convención create-<name> de la que dependen npm create arcton / pnpm create arcton / bun create arcton, re-exportando la misma implementación.
Ejemplo
bunx arcton create my-appcd my-app
bun install
bun run devTemplates
Hay dos templates de runtime disponibles; ambos scaffoldean un proyecto que depende de @arcton/core.
Template de Bun
Scripts de package.json:
{
"scripts": {
"dev": "bun --hot src/index.ts",
"start": "bun run src/index.ts",
"compile": "bun build --compile --minify --sourcemap ./src/index.ts --outfile arcton-app"
}
}src/index.ts:
import { Arcton } from '@arcton/core'
const app = Arcton()
app.get('/', () => {
return 'Hello, Arcton!'
})
app.listen()Template de Node
Scripts de package.json:
{
"scripts": {
"dev": "tsx watch src/index.ts",
"build": "tsc --build",
"start": "node dist/index.js"
}
}src/index.ts:
import { nodeAdapter } from '@arcton/adapter-node'
import { Arcton } from '@arcton/core'
const app = Arcton()
app.get('/', () => {
return 'Hello, Arcton!'
})
app.listen({ adapter: nodeAdapter })Ver Installation para los prerequisitos y Development para el uso diario de estos scripts.