bisonapp

El stack full jamstack in-a-box

Bison es un repositorio de inicio creado a partir de aplicaciones del mundo real en Echobind. Representa la "pila web Greenfield" de nuestro equipo que utilizamos al crear aplicaciones web para clientes.

¡Siempre estamos mejorando en esto, y damos la bienvenida a las sugerencias de la comunidad!

Tecnología

• Next.js
• Mecanografiado
• API TRPC para seguridad de tipo de extremo a extremo
• Prisma con postgrres
• Viento de cola
• Forma de gancho reaccionar
• Dramaturgo para pruebas de E2E
• Reaccionar la biblioteca de pruebas y la broma para las pruebas de solicitud de API y API

Características

• Plantillas de hygen personalizables para generar nuevos archivos
• Páginas de inicio de sesión/registro totalmente conectadas con la validación del cliente y del lado del servidor.
• Eslint preconfigurado con Echobind Mejores prácticas
• Importar alias de ruta a la carpeta del proyecto root ( @/ ) para evitar la necesidad de largas rutas de importación relativa.
• Configurar para componentes de ui.shadcn.com

Convenciones

• No copie/pegue archivos, use generadores y plantillas de hygen. ¿Necesita actualizar el generador a medida que evoluciona su proyecto? Todos están en la carpeta _templates .
• No escriba manualmente tipos para procedimientos TRPC. Inferir los tipos de la definición del enrutador.
• Todas las páginas frontend son estáticas de forma predeterminada. Si necesita algo reproducido, solo agregue getServerSideProps como lo haría en cualquier aplicación en la próxima.
• En lugar de crear clases de componentes CSS (como .btn o .input ) o instalar una biblioteca de componentes, los componentes de la interfaz de usuario deben copiarse/pegarse en la carpeta /components/ui y ajustarse según sea necesario. Ui.shadcn.com es la fuente recomendada para estos componentes.

Compensaciones

• Para reducir la complejidad, Bison evita los espacios de trabajo del hilo y las carpetas de nivel superior separado. Piense en su aplicación como un monolito tradicional, pero con una interfaz y API separada. Esto significa que las carpetas pueden estar un poco más entremezcladas de lo que está acostumbrado.

Alternativas

Algunos otros proyectos que están madurando rápidamente en el espacio completo de la pila Jamstack.

Redwoodjs Redwood es un marco muy prometedor que estamos viendo. Tomamos el concepto de "celdas" directamente de Redwood (¡aunque es cierto que nuestra versión toma un poco más de código!)

Blitz.js Blitz también es muy prometedor. Blitz se basa en Next.js (¡que amamos!) Y adopta un enfoque muy diferente al intentar eliminar la capa API utilizando convenciones proporcionadas por Next.js.

Podemos tomar prestados conceptos de la secoya y bombardear con el tiempo o incluso cambiar a uno a medida que continúan madurando.

Piense en el bisonte como un poco más cerca del metal y preconfigurado para la máxima DX y la eficiencia. La buena noticia es que, si no está de acuerdo con alguna de las opciones que hemos tomado, nada está oculto para usted. Puedes adaptar el "marco" para satisfacer tus necesidades.

---

Empezando

Cree un nuevo repositorio de la plantilla de bisontes.

Usando hilo:

yarn create bison-app MyApp

Usando NPX:

npx create-bison-app MyApp

Configurar la base de datos

Consulte: Configurar Postgres.

Ejecute la aplicación localmente

Desde la raíz, ejecute yarn dev . Esto ejecuta next dev para ejecutar las funciones frontend y sin servidor localmente.

Siguientes pasos

Después de que la aplicación se ejecute localmente, querrá configurar la implementación.

Documento

• Flujo de trabajo de desarrollo de desarrollo recomendado
• Despliegue

¿Tiene una idea para mejorar el bisonte? ¡Háganos saber!

---

Sobre Echobind

Echobind es una agencia digital de servicio completo que crea aplicaciones web y móviles para clientes en una variedad de industrias.

Somos expertos en React, React Native, Node, GraphQL y Rails.

Si está construyendo una nueva aplicación, su equipo está abordando un problema difícil, o simplemente necesita ayuda para superar la línea de meta, nos encantaría trabajar con usted. ¡Saluda y cuéntanos en qué estás trabajando!