Bando
GitHubComunidade

Documentação Bando

Instalação

Cria o teu primeiro projeto Bando, define o conteúdo que precisas e começa a utilizá-lo no teu site.

Neste guia vamos colocar o Bando a funcionar localmente. Não precisas conhecer toda a infraestrutura para seguir os passos.

O que vamos construir

No final deste guia teremos quatro peças trabalhando juntas:

  • Node.js — executa o runtime do Bando.
  • PostgreSQL — armazena os documentos.
  • Bando — organiza o conteúdo e disponibiliza-o para a aplicação.
  • Studio — permite gerir os conteúdos através do browser.

Pré-requisitos

Precisas de Node.js 20 ou superior, PostgreSQL e um projeto Node vazio.

Se não tens PostgreSQL instalado, podes usar Docker. Docker é apenas uma maneira conveniente de executar o PostgreSQL localmente; não é uma dependência conceitual do Bando.

  1. 1. Cria o projeto

    Primeiro cria um projeto Node. O npm init cria opackage.json, que será usado para controlar as dependências do projeto.

    BASH
    npm init -y
    npm install bando-cms
    npx bando init

    O primeiro comando cria o projeto, o segundo instala o Bando e o terceiro inicializa a configuração necessária.

  2. 2. Inicia o PostgreSQL

    O Bando precisa de uma base de dados para persistir os documentos. O comando abaixo cria um PostgreSQL local usando Docker.

    BASH
    docker run --name bando-postgres -e POSTGRES_USER=bando -e POSTGRES_PASSWORD=bando -e POSTGRES_DB=bando -p 5432:5432 -d postgres:16-alpine

  3. 3. Inicia o Bando

    Agora inicia o runtime em modo de desenvolvimento:

    BASH
    npx bando dev

    O runtime ficará disponível em:

    TEXT
    http://localhost:3333

    O Studio está disponível em:

    TEXT
    http://localhost:3333/admin

Próximo passo

Agora que o projeto está funcionando, vamos definir os tipos de conteúdo que a nossa aplicação precisa.

Configurar o Bando →
Instalação | Bando