Primeros pasos con Lino

Lino es una herramienta de línea de comandos desarrollada para acelerar la creación de aplicaciones .NET modernas, escalables y robustas. Dirigido a desarrolladores que buscan alta productividad y estándares arquitectónicos avanzados, Lino genera proyectos completos, desde microservicios independientes hasta monolitos modulares, incorporando las mejores prácticas del ecosistema .NET.

Requisitos

Antes de instalar Lino, asegúrate de que tu entorno esté correctamente configurado:

✅ .NET 9.0 SDK o superior instalado. Descargar .NET
✅ CLI de .NET disponible en el terminal. Verifica con: dotnet --version
✅ Git instalado para control de versiones. Descargar Git
✅ Entity Framework Core CLI instalada para soporte de migraciones: dotnet tool install --global dotnet-ef
✅ Entorno de contenedor compatible con OCI, como Docker Desktop o Podman.

Compatibilidad de la plataforma

Lino es multiplataforma y puede usarse en los principales sistemas operativos:

✅ Windows
✅ macOS
✅ Linux

Instalación

Lino se distribuye como una herramienta global de .NET. Antes de continuar, asegúrese de tener instalado el SDK de .NET 9 o superior.

Para instalar la versión más reciente, ejecute:

dotnet tool install --global Tolitech.Lino --version 1.0.0-alpha.10

Después de la instalación, valide el funcionamiento de Lino ejecutando:

lino --version

Si la instalación fue exitosa, la versión instalada se mostrará en el terminal.

Autenticación

Después de instalar Lino, es necesario autenticarse para acceder a todas las funcionalidades.

Si ya tienes una cuenta, inicia sesión con el siguiente comando:

lino auth login

Se te pedirá que proporciones:

Usuario: Dirección de correo electrónico previamente registrada.
Contraseña: Contraseña asociada a la cuenta.

Si aún no tienes una cuenta, regístrate directamente a través del CLI usando:

lino user register

Durante el registro, proporciona:

Nombre: Primer nombre del usuario.
Apellido: Apellido del usuario.
Correo electrónico: Dirección de correo electrónico que también servirá como login.
Contraseña: Contraseña segura de al menos 6 caracteres.
Confirmación de contraseña: Escribe nuevamente la contraseña para validarla.

Al finalizar el registro, el usuario será autenticado automáticamente.

Preferencias de idioma

Por defecto, la CLI de Lino se muestra en inglés en, pero puedes cambiar el idioma según tu preferencia entre las opciones disponibles:

en | pt | es | de | fr | it | ja | ko | ru | zh

Para establecer un nuevo idioma, ejecuta el siguiente comando:

lino preferences culture set --name culture

Alternativamente, puedes seleccionar el idioma a través de una lista interactiva con:

lino preferences culture set

Ajuste de codificación UTF-8 (opcional)

Para una visualización correcta de idiomas con caracteres especiales (como japonés, coreano, ruso o chino), asegúrate de que tu terminal esté configurado para usar la codificación UTF-8.

En PowerShell de Windows, ajusta la codificación ejecutando los siguientes comandos:

[console]::InputEncoding = [System.Text.Encoding]::UTF8

[console]::OutputEncoding = [System.Text.Encoding]::UTF8

Nota: En sistemas Linux, macOS y Windows Terminal, el soporte de UTF-8 suele ser nativo. Sin embargo, se recomienda verificar la configuración si hay problemas con la visualización de caracteres.

Comandos Disponibles

Lino está en constante evolución, recibiendo nuevos comandos y características continuamente para satisfacer las demandas de proyectos .NET de alta calidad.

Para mostrar la lista completa de comandos disponibles, ejecute en la terminal:

lino

O, alternativamente:

lino --help

La terminal mostrará una lista de los comandos principales con una breve descripción de cada uno, como en el siguiente ejemplo:

COMMANDS:
    project         Comando responsable de gestionar proyectos.
    service         Comando responsable de gestionar servicios.
    module          Comando responsable de gestionar módulos.
    entity          Comando responsable de gestionar entidades.
    enumeration     Comando responsable de gestionar enumeraciones.
    value-object    Comando responsable de gestionar objetos de valor.
    query           Comando responsable de gestionar consultas.
    command         Comando responsable de gestionar comandos.
    api             Comando responsable de gestionar APIs.
    page            Comando responsable de gestionar páginas.
    database        Comando responsable de gestionar migraciones de bases de datos.
    feature         Comando responsable de gestionar las características del proyecto.
    user            Comando responsable de gestionar usuarios.
    auth            Comando responsable de gestionar la autenticación de usuarios.
    preferences     Comando para gestionar las preferencias del usuario.

Para ver los subcomandos y opciones específicas de cualquier comando, utilice:

lino command

lino command --help

Por ejemplo, al consultar el comando project:

lino project --help

Se mostrará:

DESCRIPTION:
    Comando responsable de gestionar proyectos.

EXAMPLES:
    lino project new --name MyProject
    lino project list

COMMANDS:
    new     Comando utilizado para crear un nuevo proyecto.
    list    Comando utilizado para listar los proyectos creados.

En la próxima sección, veremos cómo crear rápidamente un nuevo proyecto con Lino.

Inicio rápido

Cree rápidamente una aplicación .NET moderna, escalable y lista para proyectos de alto nivel con el siguiente comando:

lino project new --name MyApp

Este comando genera una solución .NET estructurada con una clara separación de responsabilidades entre capas, sirviendo como base ideal para aplicaciones empresariales robustas y escalables.

MyApp/
├── MyApp.sln
├── src/
│   ├── Aspire/
│   │   ├── AppHost/
│   │   │   └── MyApp.AppHost.csproj
│   │   └── ServiceDefaults/
│   │       └── MyApp.ServiceDefaults.csproj
│   └── Services/
│       └── Shared/
│           ├── API/
│           │   └── MyApp.Shared.API.csproj
│           ├── Application/
│           │   └── MyApp.Shared.Application.csproj
│           ├── Domain/
│           │   └── MyApp.Shared.Domain.csproj
│           ├── Infrastructure/
│           │   └── MyApp.Shared.Infrastructure.csproj
│           └── Infrastructure.Persistence/
│               └── MyApp.Shared.Infrastructure.Persistence.csproj
└── tests/

Beneficios principales:

✅ Arquitectura en capas alineada con las mejores prácticas de arquitectura moderna.
🔧 Flexibilidad para escalar como microservicio, monolito modular o tradicional.
🚀 Funciones listas para usar como caché, mensajería y programación de tareas.
🧱 Base sólida para aplicar patrones como Domain-Driven Design (DDD), Event-Driven Architecture (EDA) y principios SOLID.
✨ Código limpio, opinado y altamente productivo, ideal para acelerar el desarrollo sostenible.

Con Lino, impulsa la creación de proyectos .NET de alta calidad, combinando productividad, excelencia arquitectónica y flexibilidad para seguir el crecimiento de tu aplicación.