Primeiros passos com o Lino

Pré-requisitos

Antes de instalar o Lino, verifique se seu ambiente está devidamente preparado:

• ✅ .NET 9.0 SDK ou superior instalado. Baixar .NET
• ✅ CLI do .NET disponível no terminal. Verifique com: dotnet --version
• ✅ Git instalado para controle de versão. Baixar Git
• ✅ Entity Framework Core CLI instalada para suporte a migrations: dotnet tool install --global dotnet-ef
• ✅ Ambiente de contêiner compatível com OCI, como Docker Desktop ou Podman.

Compatibilidade de Plataforma

O Lino é multiplataforma e pode ser utilizado nos principais sistemas operacionais:

• ✅ Windows
• ✅ macOS
• ✅ Linux

Instalação

O Lino é distribuído como uma ferramenta global do .NET. Antes de prosseguir, certifique-se de ter o SDK do .NET 9 ou superior instalado.

Para instalar a versão mais recente, execute:

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

Após a instalação, valide o funcionamento do Lino executando:

lino --version

Se a instalação for bem-sucedida, a versão instalada será exibida no terminal.

Autenticação

Após instalar o Lino, é necessário realizar a autenticação para acessar todas as funcionalidades.

Se já possui uma conta, efetue o login com o comando:

lino auth login

Você será solicitado a informar:

• Usuário: Endereço de e-mail previamente cadastrado.
• Senha: Senha associada à conta.

Caso ainda não tenha uma conta, registre-se diretamente pelo CLI utilizando:

lino user register

Durante o registro, informe:

• Nome: Primeiro nome do usuário.
• Sobrenome: Sobrenome do usuário.
• E-mail: Endereço de e-mail que servirá também como login.
• Senha: Senha segura com pelo menos 6 caracteres.
• Confirmação de Senha: Digite novamente a senha para validação.

Ao concluir o registro, o usuário será autenticado automaticamente.

Preferências de idioma

Por padrão, a CLI do Lino é exibida em inglês en, mas você pode alterar o idioma conforme sua preferência entre as opções disponíveis:

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

Para definir um novo idioma, execute o seguinte comando:

lino preferences culture set --name culture

Alternativamente, você pode selecionar o idioma através de uma lista interativa com:

lino preferences culture set

Ajuste de Codificação UTF-8 (opcional)

Para uma exibição correta de idiomas com caracteres especiais (como japonês, coreano, russo ou chinês), certifique-se de que seu terminal esteja configurado para utilizar a codificação UTF-8.

No Windows PowerShell, ajuste a codificação executando os seguintes comandos:

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

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

Observação: Em sistemas Linux, macOS e Windows Terminal, o suporte a UTF-8 costuma ser nativo. Ainda assim, recomenda-se validar a configuração caso ocorra algum problema na exibição de caracteres.

Comandos Disponíveis

O Lino está em constante evolução, recebendo novos comandos e recursos de forma contínua para atender às demandas de projetos .NET de alta qualidade.

Para exibir a lista completa de comandos disponíveis, execute no terminal:

lino

Ou, alternativamente:

lino --help

O terminal exibirá uma relação dos comandos principais com uma breve descrição para cada um, como no exemplo abaixo:

COMMANDS:
    project         Comando responsável por gerenciar projetos.
    service         Comando responsável por gerenciar serviços.
    module          Comando responsável por gerenciar módulos.
    entity          Comando responsável por gerenciar entidades.
    enumeration     Comando responsável por gerenciar enumerações.
    value-object    Comando responsável por gerenciar objetos de valor.
    query           Comando responsável por gerenciar consultas.
    command         Comando responsável por gerenciar comandos.
    api             Comando responsável por gerenciar APIs.
    page            Comando responsável por gerenciar páginas.
    database        Comando responsável por gerenciar migrações de banco de dados.
    feature         Comando responsável por gerenciar as funcionalidades do projeto.
    user            Comando responsável por gerenciar usuários.
    auth            Comando responsável por gerenciar autenticação de usuários.
    preferences     Comando para gerenciar preferências do usuário.

Para visualizar os subcomandos e opções específicas de qualquer comando, utilize:

lino command

Ou:

lino command --help

Por exemplo, ao consultar o comando project:

lino project --help

Será exibido:

DESCRIPTION:
    Comando responsável por gerenciar projetos.

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

COMMANDS:
    new     Comando utilizado para criar um novo projeto.
    list    Comando utilizado para listar os projetos criados.

Na próxima seção, veremos como criar rapidamente um novo projeto com o Lino.

Início Rápido

Crie rapidamente uma aplicação .NET moderna, escalável e preparada para projetos de alto nível com o seguinte comando:

lino project new --name MyApp

Esse comando gera uma solution .NET estruturada com separação clara de responsabilidades entre as camadas, servindo como base ideal para aplicações empresariais robustas e escaláveis.

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/
    

Principais Benefícios:

• ✅ Estrutura em camadas alinhada às melhores práticas de arquitetura moderna.
• 🔧 Flexibilidade para escalar como microsserviço, monólito modular ou tradicional.
• 🚀 Recursos prontos para uso, como cache, mensageria e agendamento de tarefas.
• 🧱 Base sólida para aplicar padrões como Domain-Driven Design (DDD), Event-Driven Architecture (EDA) e princípios SOLID.
• ✨ Código limpo, opinativo e altamente produtivo, ideal para acelerar o desenvolvimento sustentável.

Com o Lino, você impulsiona a criação de projetos .NET de alta qualidade, combinando produtividade, excelência arquitetural e flexibilidade para acompanhar o crescimento da sua aplicação.