gh next

Klon sederhana github di next.js

Sumber terbuka alternatif GitHub sederhana di GitHub (ironic right?), Tujuannya harus berfungsi penuh dengan beberapa fitur inti dari GitHub Working.

Lihat #84 untuk info lebih lanjut tentang fitur yang didukung.

️ Proyek ini sedang dalam pengembangan aktif ️

Harapkan barang untuk rusak.

Peta jalan

Klik untuk melihat lebih banyak

• Login/Logout
• Beranda (konten readme)
• Tata letak responsif
• Halaman Pengaturan untuk Tema Toggling
• Halaman Stargazers
• Lihat Informasi Profil
  • Perbarui Nama Pengguna
  • Ubah tema
  • Halaman detail pengguna
• Halaman Daftar Masalah
  • Pencarian & Filter Masalah oleh Penulis, Label, Penugasan, Tertutup/Terbuka, Judul, Menyebutkan, dll. (Inspirasi: https://github.com/openstatushq/openstatus, https://docs.github.com/ensues/tracking-work-work-isues-s)
• Halaman edisi baru
  • Masalah crud (hanya oleh penulis)
  • Komentar CRUD
  • Menyebutkan
  • Masalah Popovers (untuk pratinjau masalah)
  • Menghubungkan antar masalah
  • Tetapkan & Menetapkan Masalah Self
• OpenGraph
  • Pendaratan (inspirasi: https://github.com/trpc/trpc/blob/main/www/og-image/pages/api/landing.tsx)
  • Per repositori
  • Per pengguna
  • Per edisi (inspirasi: https://opengraph.githubassets.com/101e5bdeef8e959c800fab2aef88eef0b01b15d883e3e17c990bde8d67d6b3/trpc/trpc/trpc/trpcesues
• Label crud (hanya dapat menambah atau memperbarui label, tidak ada penghapusan)
• Halaman pemberitahuan
  • Lencana Pemberitahuan (Inspirasi: https://gist.github.com/fredkiss3/ab918aee3977d681f0508537a44838c0, https://github.com/fredkiss3/bunrest)
  • Langganan pemberitahuan untuk masalah
  • Pemberitahuan untuk menyebutkan
  • Pemberitahuan untuk Status Masalah
  • Pemberitahuan Filter berdasarkan Status, Judul, Tertutup, dll.
  • Tandai seperti yang dilakukan, berhenti berlangganan
• file hosting untuk repo (dengan batas penyimpanan)
  • File menjelajahi UI
  • pencarian file
• Daftar Repositori
  • Daftar Repo
  • Cari Repo
• Git web ui
  • melakukan sejarah
  • Perjalanan Waktu
  • Dukung perintah git push dan git remote
• Masalah Dewan Kanban (seperti proyek GitHub), untuk menutup masalah baik dengan komit atau dari UI
• CI/CD
  • Menjalankan CI dengan Docker, kami dapat mengambil inspirasi dari Gitlab

Tumpukan

• Router aplikasi berikutnya
• Gerimis + Database Postgres Lokal
• Di -host ke VPS khusus, lihat alur kerja CI/CD untuk bagaimana semuanya digunakan
• tailwindcss untuk gaya

Persyaratan

• Node> = v18.x
• pnpm> = v8.x
• Docker dipasang untuk pengembangan lokal
• Aplikasi github terdaftar untuk pengguna yang mengautentikasi

Bagaimana cara mengerjakan proyek?

1. Pertama, Anda harus mengkloning repositori

   git clone https://github.com/Fredkiss3/gh-next.git

2. Mulai instance Compose Docker untuk memulai instance DB + Redis:

   docker-compose up -d --remove-orphans

3. Instal dependensi:

   pnpm install

4. Ganti nama .env.example menjadi .env.local dan ubah file sesuai kebutuhan Anda,

5. Dan meluncurkan proyek:

   pnpm run dev

   Aplikasi ini akan ditampilkan di http: // localhost: 3000.

6. Buka kode sumber dan mulai goyang! ?

? Struktur proyek

Pandangan cepat pada file dan direktori tingkat atas yang akan Anda lihat dalam proyek ini.

  .
  ├── src/
  │    ├── app
  │    ├── actions
  │    ├── components
  │    ├── models
  │    └── lib/
  │         ├── client
  │         ├── server
  │         └── shared
  ├── biome.json
  ├── pnpm-lock.yaml
  └── tsconfig.json

1. src/app/ : Folder ini berisi semua rute & halaman aplikasi kami.

2. src/actions : Folder ini berisi semua logika aplikasi kami.

3. src/components : Folder ini berisi semua komponen aplikasi kami.

4. src/models : Folder ini berisi semua model DB dari aplikasi kami.

5. src/lib/ : Folder ini berisi util & pembantu yang digunakan di seluruh aplikasi kami:

   1. client : Folder ini berisi semua utilitas yang hanya klien, biasanya digunakan oleh komponen klien. Itu berisi kait terutama

   2. server : Folder ini berisi semua utilitas yang hanya server, untuk digunakan dalam komponen server dan tindakan server. Ini juga berisi skema DB di dalam db/schema

   3. shared : Folder ini berisi semua utilitas yang dibagikan antara server & klien, ini dapat digunakan di mana saja di aplikasi.

6. biome.json : File ini berisi konfigurasi untuk biome untuk mengaktifkan autoformating.

7. pnpm-lock.yaml : File ini berisi kunci dependensi untuk repo.

8. tsconfig.json : File ini berisi konfigurasi untuk naskah, yang digunakan oleh semua paket yang mendasarinya

? Variabel env digunakan

Nom	peran
SESSION_SECRET	String panjang 32 chars acak yang digunakan untuk menyandikan ID sesi
REDIS_HTTP_URL	URL ke Connect to Redis HTTP untuk Key/Value Store
DATABASE_URL	URL ke database Connect ke Postres
REDIS_HTTP_USERNAME	URL server file lokal untuk menyimpan nilai kunci
REDIS_HTTP_PASSWORD	URL server file lokal untuk menyimpan nilai kunci
GITHUB_CLIENT_ID	ID klien github disimpan untuk aplikasi kami yang digunakan untuk pengguna yang mengotentikasi dengan github
GITHUB_PERSONAL_ACCESS_TOKEN	Token klien github disimpan untuk aplikasi kami yang digunakan untuk mengotentikasi pengguna dengan github
GITHUB_REDIRECT_URI	URL untuk mengarahkan kembali saat pengguna telah diautentikasi
GITHUB_SECRET	Github Secret disimpan untuk aplikasi kami