> ## Documentation Index
> Fetch the complete documentation index at: https://docs.delixon.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting started

> Instalacion y primer proyecto en Nexenv

Nexenv es un workspace de developer construido en Rust + Tauri. Esta seccion
cubre instalacion, primer proyecto y verificacion de paridad GUI/CLI.

## Instalacion

### Instaladores nativos (GUI + CLI)

Descarga el instalador de tu plataforma desde el
[GitHub Release](https://github.com/delixon-labs/delixon-nexenv/releases/latest)
o desde `app.delixon.dev/nexenv/download`. Todos van firmados (minisign) y la GUI
verifica la firma en cada update.

* **Linux**: `.deb` (Debian/Ubuntu/Mint), `.rpm` (Fedora/RHEL/openSUSE) o
  `.AppImage` (portable, cualquier distro).
* **Windows**: `.exe` (instalador NSIS).
* **macOS**: `.dmg` (Intel `x64` y Apple Silicon `aarch64`).

<Note>
  El **auto-update in-place** desde la GUI ("Actualizar y reiniciar") funciona en
  **Windows, macOS, Linux AppImage y `.deb`/`.rpm`** (desde 1.5.2). En `.deb`/`.rpm`
  descarga el paquete, verifica su firma y lo instala con `pkexec` (pide tu
  contraseña, polkit); si no hay polkit, abre la página de descarga.
</Note>

### Wrappers (solo CLI)

* **npm**: `npm install -g @delixon/nexenv` — expone el comando `nexenv`. Sin
  postinstall obligatorio: el lanzador descarga el binario de tu plataforma de
  forma perezosa (primer uso) y verifica firma Ed25519 + SHA-256 antes de ejecutarlo.
* **pip**: `pip install nexenv` — mismo flujo de descarga perezosa.

## Primer proyecto

Desde la GUI:

1. Abrir Nexenv → boton "Nuevo proyecto" (o la pagina Scaffold).
2. Wizard por pasos: info → stack → engine → versionado → preview → genera.
   En el paso de stack, las tecnologias no implementadas aparecen como
   "Proximamente" (no seleccionables) y las que dependen de una base
   (p. ej. Vite) se habilitan al elegir su framework.
3. Selector de engine (default `nexenv-manual`, ver [Engines](./engines)).

Desde la CLI: `nexenv new mi-app --starter frontend-react-vite`
(o `--techs react,vite`), opcionalmente `--engine nexenv-manual`. Sin
argumentos, `nexenv new` abre el wizard interactivo.

## Paridad GUI ↔ CLI

Toda accion de la GUI tiene un comando CLI equivalente. `nexenv --help`
lista los comandos por categoria. Si una accion no aparece en `--help`, es un
bug — abrir issue.

## Proximos pasos

* [Project lifecycle](./project-lifecycle) — Discovered / Active / Paused.
* [Engines](./engines) — el sistema de motores pluggables.
* [TUI mode](./tui-mode) — para SSH a servidores remotos.