bisonapp

Jamstack Stack Full In-a-box

Bison adalah repositori starter yang dibuat dari aplikasi dunia nyata di Echobind. Ini mewakili "Greenfield Web Stack" tim kami yang kami gunakan saat membuat aplikasi web untuk klien.

Kami selalu meningkatkan ini, dan kami menyambut saran dari komunitas!

Teknologi

• Next.js
• Naskah
• API TRPC untuk keamanan jenis ujung ke ujung
• Prisma dengan postgres
• Tailwind
• Bentuk pengait bereaksi
• Penulis naskah untuk tes E2E
• Bereaksi Perpustakaan dan Jest untuk Tes Permintaan Unit dan API

Fitur

• Templat Hygen yang Dapat Disesuaikan untuk Menghasilkan File Baru
• Halaman login/pendaftaran sepenuhnya kabel dengan validasi klien dan sisi server.
• Eslint pra-konfigurasi dengan praktik terbaik Echobind
• Impor jalur alias ke folder proyek root ( @/ ) untuk menghindari kebutuhan akan jalur impor relatif panjang.
• Siapkan untuk komponen dari ui.shadcn.com

Konvensi

• Jangan menyalin/menempel file, menggunakan generator dan template hygen. Perlu memperbarui generator saat proyek Anda berkembang? Mereka semua ada di folder _templates .
• Jangan menulis jenis secara manual untuk prosedur TRPC. Menyimpulkan jenis dari definisi router.
• Semua halaman frontend statis secara default. Jika Anda memerlukan sesuatu yang diberikan server, cukup tambahkan getServerSideProps seperti yang Anda lakukan di aplikasi berikutnya.
• Alih -alih membuat kelas CSS komponen (seperti .btn atau .input ) atau menginstal pustaka komponen, komponen UI harus disalin/ditempelkan ke folder /components/ui dan disesuaikan sesuai kebutuhan. ui.shadcn.com adalah sumber yang disarankan untuk komponen -komponen ini.

Pengorbanan

• Untuk mengurangi kompleksitas, Bison menghindari ruang kerja benang dan memisahkan folder tingkat atas. Pikirkan aplikasi Anda seperti monolit tradisional, tetapi dengan frontend dan API yang terpisah. Ini berarti bahwa folder mungkin sedikit lebih bercampur dari yang biasa Anda lakukan.

Alternatif

Beberapa proyek lain yang dengan cepat matang di ruang Jamstack Tumpukan Penuh.

Redwoodjs Redwood adalah kerangka kerja yang sangat menjanjikan yang kami tonton. Kami mengambil konsep "sel" langsung dari Redwood (meskipun diakui versi kami mengambil sedikit lebih banyak kode!)

Blitz.js Blitz juga sangat menjanjikan. Blitz dibangun di Next.js (yang kami sukai!) Dan mengambil pendekatan yang sangat berbeda dengan mencoba menghapus lapisan API menggunakan konvensi yang disediakan oleh Next.js.

Kami dapat meminjam konsep dari Redwood dan Blitz dari waktu ke waktu atau bahkan beralih ke satu karena mereka terus matang.

Pikirkan Bison sedikit lebih dekat dengan logam dan dikonfigurasikan sebelumnya untuk DX dan efisiensi maksimum. Berita baiknya adalah, jika Anda tidak setuju dengan pilihan apa pun yang telah kami buat, tidak ada yang tersembunyi dari Anda. Anda dipersilakan untuk mengadaptasi "kerangka kerja" agar sesuai dengan kebutuhan Anda.

---

Memulai

Buat repo baru dari template bison.

Menggunakan benang:

yarn create bison-app MyApp

Menggunakan NPX:

npx create-bison-app MyApp

Siapkan database

Silakan merujuk ke: Mengatur Postgres.

Jalankan aplikasi secara lokal

Dari root, jalankan yarn dev . Ini menjalankan next dev untuk menjalankan fungsi frontend dan serverless secara lokal.

Langkah selanjutnya

Setelah aplikasi berjalan secara lokal, Anda ingin mengatur penyebaran.

Dokumen

• Alur kerja dev yang direkomendasikan
• Penyebaran

Punya ide untuk meningkatkan Bison? Beri tahu kami!

---

Tentang Echobind

Echobind adalah agen digital layanan lengkap yang membuat aplikasi web dan seluler untuk klien di berbagai industri.

Kami ahli dalam reaksi, bereaksi asli, simpul, graphql, dan rel.

Jika Anda membangun aplikasi baru, tim Anda menangani masalah yang sulit, atau Anda hanya perlu bantuan untuk mengatasi garis finish, kami ingin bekerja sama dengan Anda. Sapa dan beri tahu kami apa yang sedang Anda kerjakan!