bisonapp

Der volle Stack Jamstack in-a-box

Bison ist ein Starter-Repository aus realen Apps bei Echobind. Es repräsentiert den "Greenfield Web Stack" unseres Teams, den wir beim Erstellen von Web -Apps für Kunden verwenden.

Wir verbessern uns immer und begrüßen Vorschläge aus der Community!

Technologie

• Weiter.js
• Typoskript
• TRPC-API für die Sicherheit von End-to-End-Sicherheit
• Prisma mit Postgres
• Rückenwind
• Hakenform reagieren
• Dramatiker für E2E -Tests
• Reagieren Sie die Testbibliothek und Scherz für Einheiten- und API -Anforderungstests

Merkmale

• Anpassbare Hygen -Vorlagen zum Generieren neuer Dateien
• Vollkietee Anmeldungs-/Anmeldeseiten mit Client- und Server-Seite-Validierung.
• Eslint, vorkonfiguriert mit Echobind-Best Practices
• Importieren Sie den Pfad -Alias in den Stammprojektordner ( @/ ), um die Notwendigkeit von langen relativen Importpfaden zu vermeiden.
• Einrichten für Komponenten von ui.shadcn.com

Konventionen

• Kopieren/Einfügen keine Dateien, verwenden Sie Generatoren und Hygen -Vorlagen. Müssen Sie den Generator während der Entwicklung Ihres Projekts aktualisieren? Sie sind alle im Ordner _templates .
• Schreiben Sie nicht manuell Typen für TRPC -Prozeduren. Schließen Sie die Typen aus der Router -Definition ab.
• Alle Frontendseiten sind standardmäßig statisch. Wenn Sie einen Server benötigen, das gerendert wird, fügen Sie einfach getServerSideProps hinzu, wie Sie es in jeder nächsten App tun würden.
• Anstatt Komponenten -CSS .input /components/ui z .btn ui.shadcn.com ist die empfohlene Quelle für diese Komponenten.

Kompromisse

• Um die Komplexität zu verringern, vermeidet Bison Garnarbeitsbereiche und separate Ordner auf der oberen Ebene. Stellen Sie sich Ihre App wie einen traditionellen Monolithen vor, aber mit einem separaten Frontend und einer API. Dies bedeutet, dass Ordner möglicherweise etwas vermischten, als Sie es gewohnt sind.

Alternativen

Ein paar andere Projekte, die im vollständigen Stack Jamstack Space schnell reizen.

Redwoodjs Redwood ist ein sehr vielversprechender Rahmen, den wir sehen. Wir haben das Konzept der "Zellen" direkt von Redwood genommen (obwohl unsere Version zugegebenermaßen etwas mehr Code nimmt!)

Blitz.js Blitz ist ebenfalls sehr vielversprechend. Blitz basiert auf Next.js (was wir lieben!) Und verfolgt einen ganz anderen Ansatz, indem er versucht, die API -Schicht mit Konventionen von Next.js zu entfernen.

Wir können Konzepte von Redwood und Blitz im Laufe der Zeit ausleihen oder sogar zu einem wechseln, wenn sie weiter reifen.

Stellen Sie sich Bison als ein bisschen näher am Metall vor und vorkonfiguriert für maximale DX und Effizienz. Die gute Nachricht ist, wenn Sie mit einer der Entscheidungen, die wir getroffen haben, nicht einverstanden sind, ist nichts vor Ihnen versteckt. Sie können das "Framework" an Ihre Bedürfnisse anpassen.

---

Erste Schritte

Erstellen Sie ein neues Repo aus der Bison -Vorlage.

Mit Garn:

yarn create bison-app MyApp

Verwenden von NPX:

npx create-bison-app MyApp

Richten Sie die Datenbank ein

Bitte beziehen Sie sich: Einrichten von Postgres.

Führen Sie die App lokal aus

Führen Sie aus der Wurzel yarn dev . Dadurch wird next dev ausgeführt, um die Frontend- und Serverless -Funktionen lokal auszuführen.

Nächste Schritte

Nachdem die App lokal ausgeführt wird, möchten Sie die Bereitstellung einrichten.

Dokumente

• Empfohlener Entwicklungs -Workflow
• Einsatz

Haben Sie eine Idee, um Bison zu verbessern? Lass es uns wissen!

---

Über Echobind

Echobind ist eine digitale Agentur mit umfassendem Service, die Web- und Mobile-Apps für Kunden in einer Vielzahl von Branchen erstellt.

Wir sind Experten in React, React Native, Node, GraphQL und Rails.

Wenn Sie eine neue App erstellen, Ihr Team ein hartes Problem angeht oder Sie nur Hilfe beim Überwachen der Ziellinie benötigen, würden wir gerne mit Ihnen zusammenarbeiten. Sag Hallo und sag uns, woran du arbeitest!