bisonapp

完整的堆栈jamstack in-a-box

Bison是由Echobind的现实世界应用创建的入门存储库。它代表了我们在为客户创建Web应用时使用的团队的“ Greenfield Web堆栈”。

我们一直在进步，我们欢迎社区的建议！

技术

• next.js
• 打字稿
• 端到端类型安全的TRPC API
• 带有邮政的Prisma
• 尾风
• React Hook形式
• E2E测试的剧作家
• 对单位和API请求测试的React测试库和开玩笑

特征

• 可自定义的海根模板生成新文件
• 带有客户端和服务器端验证的完全有线登录/注册页面。
• Eslint与Echobind最佳实践预先配置
• 导入路径别名到根项目文件夹（ @/ ），以避免需要长期相对导入路径。
• 从UI.shadcn.com设置组件

会议

• 不要复制/粘贴文件，使用发电机和海根模板。需要随着项目的发展而更新发电机？它们都在_templates文件夹中。
• 不要为TRPC过程手动编写类型。从路由器定义中推断类型。
• 默认情况下，所有前端页面都是静态的。如果您需要一些服务器渲染的东西，只需在任何下一个应用中添加getServerSideProps即可。
• UI组件不应复制/粘贴到/components/ui文件夹中并根据需要进行调整，而不是创建组件CSS类（例如.btn或.input ）或安装组件库，而是要复制/粘贴到/组件/UI文件夹中。 ui.shadcn.com是这些组件的推荐来源。

权衡

• 为了降低复杂性，野牛避免了纱线工作区和单独的顶级文件夹。将您的应用程序视为传统的整体，但具有单独的前端和API。这意味着文件夹可能比您习惯的更加混合。

替代方案

其他一些在完整的堆栈jamstack空间中迅速成熟的项目。

Redwoodjs Redwood是我们正在观看的一个非常有前途的框架。我们直接从Redwood采用了“单元格”的概念（尽管肯定是我们的版本需要更多代码！）

Blitz.js Blitz也非常有前途。 Blitz建立在Next.js上（我们喜欢！），并尝试使用Next.js提供的约定删除API层来采用截然不同的方法。

随着时间的流逝，我们可能会从Redwood和Blitz借用概念，甚至可以在继续成熟时切换到一个概念。

将野牛视为靠近金属的近距离，并预先配置，以最大程度地达到DX和效率。好消息是，如果您不同意我们做出的任何选择，那么您就不会隐藏。欢迎您调整“框架”以满足您的需求。

---

入门

从野牛模板中创建一个新的存储库。

使用纱线：

yarn create bison-app MyApp

使用NPX：

npx create-bison-app MyApp

设置数据库

请参考：设置Postgres。

本地运行应用程序

从根中，运行yarn dev 。这将运行next dev在本地运行前端和无服务器功能。

下一步

应用程序在本地运行后，您将需要设置部署。

文档

• 推荐开发工作流程
• 部署

有改善野牛的想法吗？让我们知道！

---

关于Echobind

Echobind是一家提供全方位服务的数字代理商，为各个行业的客户创建网络和移动应用程序。

我们是React，React Native，Node，GraphQL和Rails的专家。

如果您正在构建一个新应用程序，那么您的团队将解决一个严重的问题，或者您只需要帮助终点线，我们很乐意与您合作。打个招呼，告诉我们您在做什么！