gh next

Un simple clon de Github en Next.js

Un código abierto alternativo de GitHub simple en GitHub (¿irónico, ¿verdad?), Se dirige es ser completamente funcional con algunas de las características centrales del trabajo de GitHub.

Consulte el #84 para obtener más información sobre las características compatibles.

️ Este proyecto está en desarrollo activo ️

Espere que las cosas se rompan.

Hoja de ruta

Haga clic para ver más

• Iniciar sesión/sesión
• Página de inicio (contenido de readMe)
• Diseño receptivo
• Página de configuración para alternar tema
• Página de Stargazers
• Ver información de perfil
  • Actualizar el nombre de usuario
  • Cambiar tema
  • Página de detalles del usuario
• Página de la lista de problemas
  • Problemas de búsqueda y filtro por autor, etiqueta, cesionario, cerrado/abierto, título, menciones, etc. (Inspiración: https://github.com/openstatushq/openstatus, https://docs.github.com/en/issues/tracking-your-work-with-issues/filtering-and-searching-issues-andpull-requests)
• Página de nuevo número
  • Problema Crud (solo por el autor)
  • Comentarios Crud
  • Menciones
  • Problema Popovers (para obtener una vista previa de problemas)
  • Vinculación entre problemas
  • Asignar y asignar problemas
• Cárter
  • aterrizaje (inspiración: https://github.com/trpc/trpc/blob/main/www/og-image/pages/api/landing.tsx)
  • Por repositorio
  • Por usuario
  • Por número (Inspiración: https://opengraph.githubassets.com/101e5bdeef8e959c800fab2aef88eef0b01b15d883e3e17c990bde8dfd67d6b3/trpc/trpc/issues/4306)
• Las etiquetas crud (solo pueden agregar o actualizar etiquetas, sin eliminar)
• Página de notificaciones
  • Insignia de notificaciones (Inspiración: https://gist.github.com/fredkiss3/ab918aee3977d681f0508537a44838c0, https://github.com/fredkiss3/bunrest)
  • Notificaciones para problemas de suscripciones
  • Notificaciones por menciones
  • Notificaciones para los estados de emisión
  • Notificaciones de filtro por estado, título, cerrado, etc.
  • Mark como lo hizo, cancelar la suscripción
• Alojamiento de archivos para repos (con un límite de almacenamiento)
  • UI de navegación de archivos
  • búsqueda de archivos
• Lista de repositorio
  • Lista de repos
  • Buscar repos
• Git web ui
  • cometer historia
  • viaje en el tiempo
  • Admite comandos git remote git push and Git
• Problema Kanban Board (como proyectos de Github), para cerrar un problema con un compromiso o de la interfaz de usuario
• CI/CD
  • Ejecutando CI con Docker, podemos inspirarnos en Gitlab

Pila

• Siguiente enrutador de aplicaciones
• Rociedad + base de datos local de postgrres
• Alojado a un VPS personalizado, consulte el flujo de trabajo CI/CD para ver cómo está todo implementado
• Tailwindcss para el estilo

Requisitos

• Nodo> = v18.x
• pnpm> = v8.x
• Docker instalado para el desarrollo local
• Una aplicación GitHub registrada para autenticar a los usuarios

¿Cómo trabajar en el proyecto?

1. Primero tienes que clonar el repositorio

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

2. Inicie la instancia de Docker Compose para iniciar la instancia de DB + Redis:

   docker-compose up -d --remove-orphans

3. Instale las dependencias:

   pnpm install

4. Renombrar .env.example a .env.local y cambie el archivo a sus necesidades,

5. Y lanza el proyecto:

   pnpm run dev

   La aplicación se mostrará en http: // localhost: 3000.

6. ¡Abra el código fuente y comience a rockear! ?

? Estructura de proyectos

Un vistazo rápido a los archivos y directorios de nivel superior que verá en este proyecto.

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

1. src/app/ : Esta carpeta contiene todas las rutas y páginas de nuestra aplicación.

2. src/actions : esta carpeta contiene toda la lógica de nuestra aplicación.

3. src/components : esta carpeta contiene todos los componentes de nuestra aplicación.

4. src/models : esta carpeta contiene todos los modelos DB de nuestra aplicación.

5. src/lib/ : esta carpeta contiene UTILS y ayudantes utilizados en toda nuestra aplicación:

   1. client : esta carpeta contiene todas las utilidades que son solo para el cliente, generalmente utilizadas por los componentes del cliente. Contiene principalmente ganchos

   2. server : esta carpeta contiene todas las utilidades que son solo para el servidor, para su uso dentro de los componentes del servidor y las acciones del servidor. También contiene los esquemas de DB dentro de db/schema

   3. shared : esta carpeta contiene todas las utilidades que se comparten entre el servidor y el cliente, se pueden usar en cualquier lugar de la aplicación.

6. biome.json : este archivo contiene la configuración de Bioma para habilitar el autoformating.

7. pnpm-lock.yaml : este archivo contiene el bloqueo de dependencias para el repositorio.

8. tsconfig.json : este archivo contiene la configuración para TypeScript, que utilizan todos los paquetes subyacentes

? Variables de env se usan

Nominar	role
SESSION_SECRET	Cadena de longitud aleatoria de 32 chars utilizada para codificar la ID de sesión
REDIS_HTTP_URL	La URL a la conexión a Redis HTTP para una tienda de clave/valor
DATABASE_URL	La URL a la base de datos de conectar a la base de postres
REDIS_HTTP_USERNAME	URL del servidor de archivos local para almacenar valores clave
REDIS_HTTP_PASSWORD	URL del servidor de archivos local para almacenar valores clave
GITHUB_CLIENT_ID	ID de cliente GitHub almacenada para nuestra aplicación utilizada para autenticar a los usuarios con GitHub
GITHUB_PERSONAL_ACCESS_TOKEN	Token de cliente GitHub almacenado para nuestra aplicación utilizada para autenticar a los usuarios con GitHub
GITHUB_REDIRECT_URI	URL para redirigir cuando un usuario ha sido autenticado
GITHUB_SECRET	Secreto de Github almacenado para nuestra aplicación