القائمة
Desplegar frontend estático en GitHub Pages — estructura, rutas, .nojekyll, proxy API a backend externo, y troubleshooting.
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
استنادا إلى تصنيف SOC المهني
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/Ntizar/koldo --skill github-pages-staticيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
عرض SKILL.md
Skills del sistema Mastermind - agente principal, dashboards, deploy, voz, APIs y automatización para Ntizar.
Búsqueda semántica de skills usando ChromaDB local + qwen3-embedding (NaN API). Indexa 190+ skills como vectores 4096-dim y consulta por similitud para cargar solo los relevantes.
Free web search via DuckDuckGo — text, news, images, videos. No API key needed. Prefer the `ddgs` CLI when installed; use the Python DDGS library only after verifying that `ddgs` is available in the current runtime.
| name | github-pages-static |
| description | Desplegar frontend estático en GitHub Pages — estructura, rutas, .nojekyll, proxy API a backend externo, y troubleshooting. |
| version | 1.0.0 |
| author | Mastermind |
| tags | ["github","pages","static","deployment"] |
Desplegar un frontend HTML/CSS/JS estático en GitHub Pages, con routing de API a un backend externo (NaN, Vercel, etc.).
repo/
├── .nojekyll ← OBLIGATORIO: desactiva Jekyll para servir HTML/JS/CSS puro
├── index.html ← EN LA RAÍZ (GitHub Pages busca index.html aquí)
├── css/styles.css
├── js/
│ ├── api-config.js ← Proxy de API a backend externo
│ ├── config.js
│ ├── ...
└── README.md ← Opcional (si existe, Jekyll lo procesa a menos que haya .nojekyll)
curl -X POST https://api.github.com/user/repos -H "Authorization: Bearer $TOKEN" -d '{"name":"xxx","private":false}'.nojekyll en la raíz — desactiva Jekyll para servir archivos tal cualindex.html en la raíz — GitHub Pages NO busca en subdirectoriosmain — GitHub Pages detecta automáticamentecurl -X POST https://api.github.com/repos/OWNER/REPO/pages -H "Authorization: Bearer $TOKEN" -d '{"source":{"branch":"main","path":"/"}}'https://<usuario>.github.io/<repo>/README.md en la raíz → GitHub Pages sirve una página Jekyll en vez del HTML.nojekyll en la raíz (archivo vacío vale)README.txt o moverlo a docs/index.html debe estar en la raíz del repo, no en public/ o src/public/), mover todo a la raízsrc="js/...", href="css/..." (sin public/ prefix)app.a1b2c3.js)process.envapi-config.js que se carga primero y reescribe fetch()/api/* y redirigir al backend externo// api-config.js — cargar ANTES que cualquier otro JS
const BACKEND_URL = 'https://tu-backend.nan.builders';
// Override global fetch para reencaminar /api/* al backend
const originalFetch = window.fetch;
window.fetch = function(url, options) {
if (typeof url === 'string' && url.startsWith('/api/')) {
url = BACKEND_URL + url;
}
return originalFetch.call(this, url, options);
};
Inyectar en HTML antes de los otros scripts:
<script src="js/api-config.js"></script>
<script src="js/config.js"></script>
NUNCA exponer tokens API en el frontend de GitHub Pages (visible en DevTools).
Si se necesita un token:
| Síntoma | Causa | Fix |
|---|---|---|
404 en / | Jekyll procesando en vez de HTML | .nojekyll en raíz |
404 en / | index.html no en raíz | Mover index.html a raíz del repo |
| HTML se ve pero CSS/JS no | Rutas relativas mal | Verificar href="css/..." y src="js/..." |
| API calls fallan CORS | Backend no permite CORS | Configurar Access-Control-Allow-Origin en backend |
| API calls van a localhost | api-config.js no se carga | Verificar orden de scripts en HTML |
| Página Jekyll en vez del app | README.md en raíz | .nojekyll + eliminar README de raíz |
| Cambios no se ven | Cache de GitHub Pages | Esperar 1-2 min, o hard refresh |
# 1. HTML se sirve
curl -s https://usuario.github.io/repo/ | head -5
# 2. CSS/JS cargan
curl -s -o /dev/null -w "%{http_code}" https://usuario.github.io/repo/css/styles.css
curl -s -o /dev/null -w "%{http_code}" https://usuario.github.io/repo/js/config.js
# 3. API proxy funciona (si aplica)
# Verificar en DevTools Network que /api/* se redirige al backend
references/github-pages-api-proxy.md — patrón API proxy con ejemplostemplates/github-pages-starter/ — template mínimo para copiar