Introdução ao EmDash

Nesta página

EmDash é um sistema de gerenciamento de conteúdo nativo do Astro. Ele traz padrões familiares de CMS — coleções, taxonomias, menus, widgets e uma interface de administração refinada — diretamente para o seu site Astro com suporte completo ao TypeScript e implantação portável.

O que é EmDash

EmDash é um CMS construído especificamente para Astro. Ele usa as Live Content Collections do Astro 6 para servir conteúdo em tempo de execução, então as edições aparecem imediatamente. O conteúdo é armazenado em um banco de dados SQL — SQLite, libSQL, Cloudflare D1 ou PostgreSQL — e mídia em armazenamento compatível com S3 (R2 ou sistema de arquivos local).

Características principais:

  • Modelagem visual de conteúdo — Defina e altere coleções e campos pela interface de administração; as alterações entram em vigor imediatamente.
  • Live Collections — O conteúdo é servido em tempo de execução, então as edições aparecem imediatamente.
  • Sistema de plugins — Hooks inspirados em WordPress, armazenamento, configurações e extensões da interface de administração.
  • Cloud-portable — Funciona no Cloudflare (Workers + D1 + R2) ou Node.js, com SQLite, libSQL ou PostgreSQL e qualquer armazenamento compatível com S3.

O que EmDash não é

  • Não é um CMS headless — EmDash está intimamente integrado ao Astro e funciona na mesma implantação, em vez de como um serviço separado que você chama por meio de uma API.
  • Não é compatível com WordPress — Não executa PHP nem plugins do WordPress. Conteúdos e conceitos do WordPress migram para equivalentes do EmDash.
  • Não é um construtor de páginas — EmDash gerencia conteúdo estruturado. Construa layouts visuais com componentes Astro.

Para quem é o EmDash

Desenvolvedores de agência

Crie sites de clientes rapidamente com plugins e temas reutilizáveis. Plugins são executados em contextos isolados com APIs explícitas.

Desenvolvedores solo

O gerenciamento de conteúdo faz parte do site Astro, implantado e gerenciado como um único projeto.

Editores de conteúdo

Crie e edite conteúdo no painel de administração.

Usuários WordPress

Caminho de migração para conteúdo e plugins. Ferramentas modernas, conceitos familiares.

Arquitetura em resumo

O diagrama a seguir mostra como EmDash se encaixa em um site Astro, conectando o motor de conteúdo, painel de administração e plugins à camada de dados.

┌─────────────────────────────────────────────────────────────┐
│                      Your Astro Site                        │
│                                                             │
│  ┌───────────────────────────────────────────────────────┐  │
│  │                 EmDash Integration                  │  │
│  │                                                       │  │
│  │  ┌─────────────┐  ┌─────────────┐  ┌──────────────┐   │  │
│  │  │  Content    │  │   Admin     │  │   Plugins    │   │  │
│  │  │  Engine     │  │   Panel     │  │              │   │  │
│  │  └─────────────┘  └─────────────┘  └──────────────┘   │  │
│  │                                                       │  │
│  │  ┌───────────────────────────────────────────────────┐│  │
│  │  │                  Data Layer                       ││  │
│  │  │Database (SQLite/libSQL/D1/Postgres) + media store ││  │
│  │  └───────────────────────────────────────────────────┘│  │
│  └───────────────────────────────────────────────────────┘  │
│                                                             │
│  ┌───────────────────────────────────────────────────────┐  │
│  │                   Astro Framework                     │  │
│  │        Live Collections • Sessions • Middleware       │  │
│  └───────────────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────────────┘

Conceitos fundamentais

Estes são os conceitos-chave usados em toda a documentação:

  • Collections — Tipos de conteúdo definidos no banco de dados (posts, páginas, produtos, etc.)
  • Fields — As propriedades de uma coleção (título, conteúdo, preço, etc.)
  • Taxonomies — Sistemas de classificação (categorias, tags, taxonomias personalizadas)
  • Menus — Estruturas de navegação editáveis pelo administrador
  • Widget Areas — Regiões de conteúdo configuráveis para barras laterais e rodapés
  • Plugins — Extensões que adicionam funcionalidade via hooks, armazenamento e interface do usuário

Próximos passos