https://github.com/herwingx/awesome-github-search
Buscador de repositorios de GitHub por tema, construido con HTML, CSS y JavaScript. Utiliza la API de GitHub para obtener resultados en tiempo real.
https://github.com/herwingx/awesome-github-search
List: awesome-github-search
css fetch github-api html javascript
Last synced: about 13 hours ago
JSON representation
Buscador de repositorios de GitHub por tema, construido con HTML, CSS y JavaScript. Utiliza la API de GitHub para obtener resultados en tiempo real.
- Host: GitHub
- URL: https://github.com/herwingx/awesome-github-search
- Owner: herwingx
- Created: 2025-02-21T16:25:30.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2026-01-02T18:19:28.000Z (26 days ago)
- Last Synced: 2026-01-09T05:48:33.401Z (19 days ago)
- Topics: css, fetch, github-api, html, javascript
- Language: CSS
- Homepage: http://ghsearch.is-a.dev/
- Size: 81.1 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🔍 Awesome GitHub Search
> **Explora el universo de código** — Un buscador de repositorios minimalista y potente impulsado por la API de GitHub en tiempo real.
[](https://ghsearch.is-a.dev/)
[](https://tailwindcss.com/)
[](LICENSE)
---
## ✨ Características
| Característica | Descripción |
| :--------------------- | :------------------------------------------------------------------------ |
| ⚡ **Búsqueda en Vivo** | Consultas en tiempo real a la API de GitHub para resultados instantáneos. |
| 🎨 **UI Moderna** | Diseño limpio y minimalista construido con Tailwind CSS. |
| 📱 **Responsive** | Adaptable a cualquier dispositivo, desde móviles hasta escritorio. |
| 🔌 **Serverless** | Funciona directamente en el navegador sin necesidad de servidor backend. |
| 📊 **Datos Ricos** | Muestra estrellas, descripciones y enlaces directos a los repositorios. |
---
## 🚀 Inicio Rápido
### Requisitos
- Node.js & npm (solo para desarrollo de estilos)
- Navegador Web Moderno
### 1. Clonar el repositorio
Usa GitHub CLI para una experiencia optimizada:
```bash
gh repo clone herwingx/awesome-github-search
cd awesome-github-search
```
### 2. Instalar dependencias
Necesario para compilar los estilos de Tailwind CSS.
```bash
npm install
```
### 3. Desarrollo Local
Para observar cambios en CSS y regenerar los estilos automáticamente:
```bash
# En una terminal dedicada
npx tailwindcss -i ./src/input.css -o ./src/output.css --watch
```
Luego abre `index.html` en tu navegador o usa una extensión como Live Server.
---
## 🏗️ Arquitectura
La aplicación sigue una arquitectura SPA (Single Page Application) ligera sin dependencias de compilación complejas para el runtime.
```mermaid
graph TD
User(["👤 Usuario"]) -->|Escribe Búsqueda| UI["💻 Interfaz Web"]
UI -->|Evento Input| JS["⚙️ Lógica (script.js)"]
JS -->|Fetch Request| API["☁️ GitHub REST API"]
API -->|JSON Response| JS
JS -->|Update DOM| UI
style UI fill:#f9f,stroke:#333
style API fill:#bbf,stroke:#333
```
---
## 📦 Opciones de Despliegue
| Método | Archivo | Ideal para |
| :--------------- | :----------------- | :----------------------- |
| **GitHub Pages** | `Settings > Pages` | Producción (Recomendado) |
| Local | `index.html` | Desarrollo / Pruebas |
---
## 🔧 Comandos Útiles
```bash
# Compilar CSS para producción (minificado)
npx tailwindcss -i ./src/input.css -o ./src/output.css --minify
# Verificación de estilos
npm run test # (Si está configurado)
```
---
## 🛠️ Stack Tecnológico
**Frontend**
- **HTML5**: Estructura semántica.
- **CSS3 (Tailwind)**: Estilizado utilitario y diseño responsivo.
- **JavaScript (ES6+)**: Lógica asíncrona y manipulación del DOM.
**Integraciones**
- **GitHub API**: Fuente de datos de repositorios.
---
## 🤝 Contribuir
1. Fork del repositorio
2. Crear rama: `git checkout -b feat/nueva-feature`
3. Commit: `git commit -m "feat: agrega búsqueda avanzada"`
4. Push: `git push origin feat/nueva-feature`
5. Crear Pull Request
## 📄 Licencia
Este proyecto está bajo la licencia MIT. Ver [LICENSE](LICENSE) para más detalles.
---
Hecho con ❤️ por Eduardo Macías