LinkHub Project

LinkHub es una aplicación web de código abierto diseñada para permitir a los usuarios guardar, organizar y descubrir recursos web de manera eficiente. Inspirado en la necesidad de tener un lugar centralizado donde las personas puedan acceder a enlaces útiles recomendados por una comunidad, LinkHub busca simplificar la forma en que interactuamos con la información en línea.

🚀 Despliegue

Visita LinkHub para ver la aplicación en acción.

📚 Stack de Tecnologías

Este proyecto utiliza un stack moderno y eficiente para proporcionar una experiencia de usuario excepcional y un desarrollo ágil:

• Astro.build: Un moderno generador de sitios estáticos que te permite construir interfaces de usuario rápidas y eficientes.
• Preact: Una alternativa ligera a React con la misma API moderna, permitiendo un rendimiento superior y tamaños de paquete más pequeños.
• TypeScript: TypeScript para tener nuestro javascript fuertemente tipado sea mas fácil escalarlo y mantenerlo.
• Tailwind: Un marco CSS de utilidad repleto de clases que se pueden componer para crear cualquier diseño, directamente en las etiquetas html.
• Nanostores: Un ligero manejador de estados. Utiliza muchos almacenes atómicos y manipulación directa.

El diseño

La idea del proyecto esta plasmanda en este enlace de figma. Sin embargo no algo oficial, la verdadera fuente de inspiración del estilo es Notion

🏗️ Configuración del Proyecto

Requisitos Previos

Asegúrate de tener instalado Node.js en tu sistema para poder trabajar con Astro y Preact. Puedes descargarlo desde nodejs.org.

Instalación

Clona este repositorio en tu máquina local y navega al directorio del proyecto:

git clone https://github.com/doneber/linkhub
cd linkhub

Instala las dependencias del proyecto:

npm install

Ejecutar en Desarrollo

Para iniciar el servidor de desarrollo y trabajar en mejoras:

npm run dev

Visita http://localhost:4321 para ver tu proyecto en acción.

Construir para Producción

Para construir tu proyecto para producción, ejecuta:

npm run build

🤝 Cómo Contribuir

Estamos encantados de recibir contribuciones de la comunidad. Para empezar:

1. Forkea el repositorio.
2. Crea una nueva rama para tus cambios (git checkout -b feature/miNuevaCaracteristica).
3. Haz tus cambios y commit (git commit -am 'Añadiendo una nueva característica').
4. Push a la rama (git push origin feature/miNuevaCaracteristica).
5. Abre un Pull Request.

Consulta nuestro archivo CONTRIBUTING.md para más información sobre cómo contribuir al proyecto.

📜 Licencia

Este proyecto está licenciado bajo la Licencia MIT - vea el archivo LICENSE.md para detalles.

📢 Agradecimientos 🤝

¡Gracias a todos los contribuyentes!.

🔑 Como obtener tu Github Client ID y Secret

Before being able to initialize the application, you will need to obtain your client ID and client secret from Twitch.

Primero, Tienes que ir github.com/settings/developers

Luego de que este ahi tienes que darle click donde dice 'New OAuth App' en la esquina derecha.

Entonces necesitaras registrar tu app. Llena los campos como el siguiente ejemplo y dale click al boton 'Register application'.

Despues de eso, la pagina te redirigira al panel de administracion. Donde estara tu client ID como se muestra a continuacion:

Finnalmente, necesitaras tu client secret. Debajo del lugar donde esta tu client ID, encontraras el boton 'new secret'; dale click para obtener tu secreto.

Finally, you'll need your client secret. Below the place where you obtained your client ID, you'll find the 'generate a new secret' button; click on it to get your secret.

No olvides agregarlo a tu archivo .env guiandote del archivo .env.example