bisonapp

A pilha completa Jamstack em uma caixa

Bison é um repositório inicial criado a partir de aplicativos do mundo real na Echobind. Ele representa a "pilha da web Greenfield" da nossa equipe que usamos ao criar aplicativos da web para clientes.

Estamos sempre melhorando nisso, e agradecemos sugestões da comunidade!

Tecnologia

• Next.js
• TypeScript
• API TRPC para segurança do tipo de ponta a ponta
• PRISMA com Postgres
• Tailwind
• React fort fort
• Dramaturgo para testes E2E
• React Testing Library e Jest for Unit and API Solicle Testes

Características

• Modelos de hygen personalizáveis para gerar novos arquivos
• Páginas de login/inscrição totalmente conectadas com validação do cliente e do servidor.
• Eslint pré-configurado com práticas recomendadas de ecobind
• Importar o alias do caminho para a pasta raiz do projeto ( @/ ) para evitar a necessidade de caminhos de importação relativos longos.
• Configurado para componentes da UI.shadcn.com

Convenções

• Não copie/cole arquivos, use geradores e modelos de hygen. Precisa atualizar o gerador à medida que seu projeto evolui? Eles estão todos na pasta _templates .
• Não escreva manualmente os tipos de procedimentos TRPC. Inferir os tipos da definição do roteador.
• Todas as páginas de front -end são estáticas por padrão. Se você precisar de algo renderizado, basta adicionar getServerSideProps como faria em qualquer aplicativo próximo.
• Em vez de criar classes CSS componentes (como .btn ou .input ) ou instalar uma biblioteca de componentes, os componentes da interface do usuário devem ser copiados/colados na pasta /components/ui e ajustados conforme necessário. ui.shadcn.com é a fonte recomendada para esses componentes.

Compensações

• Para reduzir a complexidade, o bisonte evita espaços de trabalho de fios e pastas de nível superior separadas. Pense no seu aplicativo como um monólito tradicional, mas com um front -end e API separados. Isso significa que as pastas podem ser um pouco mais misturadas do que você está acostumado.

Alternativas

Alguns outros projetos que estão amadurecendo rapidamente no espaço de jamstack de pilha completa.

Redwoodjs Redwood é uma estrutura muito promissora que estamos assistindo. Pegamos o conceito de "células" diretamente de Redwood (embora reconheçosamente nossa versão tenha um pouco mais de código!)

Blitz.js Blitz também é muito promissor. Blitz é construído no Next.js (que amamos!) E adota uma abordagem muito diferente tentando remover a camada da API usando convenções fornecidas por Next.JS.

Podemos emprestar conceitos de Redwood e Blitz ao longo do tempo ou até mudar para um à medida que continuam a amadurecer.

Pense no bisonte um pouco mais próximo do metal e pré -configurado para o máximo DX e a eficiência. A boa notícia é que, se você discordar de alguma das escolhas que fizemos, nada está escondido de você. Você pode adaptar a "estrutura" para atender às suas necessidades.

---

Começando

Crie um novo repo a partir do modelo de bisonte.

Usando o fio:

yarn create bison-app MyApp

Usando NPX:

npx create-bison-app MyApp

Configure o banco de dados

Consulte: Configure o PostGres.

Execute o aplicativo localmente

Da raiz, execute yarn dev . Isso é executado next dev para executar as funções sem servidor e sem servidor localmente.

PRÓXIMOS PASSOS

Depois que o aplicativo estiver em execução localmente, você deseja configurar a implantação.

Documentos

• Fluxo de trabalho recomendado de desenvolvimento
• Implantação

Tem uma ideia para melhorar o bisonte? Deixe -nos saber!

---

Sobre ecobind

A ECHOBIND é uma agência digital de serviço completo que cria aplicativos da Web e móveis para clientes em vários setores.

Somos especialistas em React, React Native, Node, GraphQL e Rails.

Se você está construindo um novo aplicativo, sua equipe está enfrentando um problema difícil ou você só precisa de ajuda para superar a linha de chegada, adoraríamos trabalhar com você. Diga olá e diga -nos no que você está trabalhando!