archteturis

CLI e runtime oficial do Archteturis para criar bots Discord.js com uma base moderna, modular, bonita e pronta para crescer.

Este pacote nao instala apenas um gerador de arquivos. Ele cria uma base completa com:

• runtime oficial vindo de node_modules/archteturis
• carregamento automatico de comandos e eventos
• estrutura pensada para slash commands
• comandos e eventos de exemplo prontos
• terminal com interface em portugues, colorida, amigavel e com navegacao por setas

Instalacao

Sem instalar globalmente:

npx archteturis init meu-bot

Instalacao global:

npm install -g archteturis

Depois:

archteturis init meu-bot

Fluxo rapido

Crie a base:

archteturis init meu-bot

Entre na pasta e rode:

cd meu-bot
npm install
npm run dev

O que a CLI gera

O template inicial vem com:

• src/commands/info/ping.ts
• src/commands/admin/painel.ts
• src/commands/utils/avatar.ts
• src/events/once/ready.ts usando o evento clientReady
• src/events/on/guildCreate.ts
• src/config/bot.ts
• .env.example

Estrutura da base

src/
  commands/
    admin/
    info/
    utils/
  events/
    on/
    once/
  config/
    bot.ts
  index.ts

Como funciona

Quando voce roda archteturis init, a CLI copia um template completo para o seu projeto e configura a dependencia archteturis no package.json.

Na pratica isso significa:

• o projeto fica mais limpo, sem uma pasta core aparecendo dentro de src
• o runtime do bot fica em node_modules/archteturis
• voce continua podendo extender sua base livremente
• o projeto nasce organizado para crescer sem excesso de boilerplate

Comandos disponiveis

Inicializar um projeto:

archteturis init [nome-do-bot]
archteturis init [nome-do-bot] --aqui
archteturis init [nome-do-bot] --nova-pasta

Gerar comandos:

archteturis add command ping
archteturis add command info/ping
archteturis add command admin/banir
archteturis add command admin/moderacao/banir

Gerar eventos:

archteturis add event clientReady
archteturis add event once/clientReady
archteturis add event on/guildCreate
archteturis add event on/client/guildMemberAdd

Organizacao recomendada

• use commands/info para comandos informativos
• use commands/admin para administracao e moderacao
• use commands/utils para utilidades gerais
• use events/once para eventos que rodam uma unica vez
• use events/on para eventos recorrentes

O que o pacote exporta

O archteturis ja entrega:

• ArchClient
• loader automatico de comandos
• loader automatico de eventos
• helper createCommand
• helper createEvent
• tipagens do cliente, comandos e eventos
• logger simples para terminal

Para quem isso serve

O Archteturis foi pensado para quem quer:

• subir um bot Discord.js moderno sem montar toda a infraestrutura na mao
• reduzir boilerplate
• manter uma arquitetura limpa
• comecar rapido sem perder capacidade de evolucao

Desenvolvimento local do pacote

Na monorepo:

npm install
npm run build --workspace archteturis
node packages/cli/dist/cli.mjs --help