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的專家。

如果您正在構建一個新應用程序，那麼您的團隊將解決一個嚴重的問題，或者您只需要幫助終點線，我們很樂意與您合作。打個招呼，告訴我們您在做什麼！