Skip to content
Back to search

mcp-higgsfield-landing

Landing de Arko, restaurante nikkei de Barcelona: un paseo en vídeo por el local al hacer scroll, generado con Higgsfield MCP y Claude Code. Astro, GSAP, Lenis y Cloudflare Workers.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/midudev--mcp-higgsfield-landing/badge.svg)](/listings/midudev--mcp-higgsfield-landing)

HTML

<a href="/listings/midudev--mcp-higgsfield-landing"><img src="/api/listings/midudev--mcp-higgsfield-landing/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 146 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Arko · Landing con scroll world
  2. <a href="https://arko-sushi.midudev.workers.dev">
  3. <picture>
  4. <source srcset="https://raw.githubusercontent.com/midudev/mcp-higgsfield-landing/main/docs/scroll-desktop.avif" type="image/avif">
  5. <img src="public/og-image.jpg" alt="Scroll por la landing de Arko en escritorio: el paseo por el local avanza con el scroll y después aparecen los platos, las experiencias, las preguntas frecuentes y el pie">
  6. </picture>
  7. </a>
  8. Landing de [Arko](https://www.arkorestaurant.com), restaurante de cocina nikkei en Carrer Enric Granados 63, en el Eixample de Barcelona. Está publicada en **[arko-sushi.midudev.workers.dev](https://arko-sushi.midudev.workers.dev)**.
  9. La portada es un **paseo por el local que avanza y retrocede con el scroll**. Son seis clips generados con IA (MiniMax H3 a través de Higgsfield) a partir de siete fotos reales del restaurante, y cada uno une una foto con la siguiente. La web se montó con Claude Code, y todos los prompts que se usaron están en [`PROMPTS.md`](PROMPTS.md).
  10. **Stack:** [Astro 7](https://astro.build) · [Tailwind CSS 4](https://tailwindcss.com) · [GSAP ScrollTrigger](https://gsap.com/docs/v3/Plugins/ScrollTrigger/) · [Lenis](https://lenis.darkroom.engineering) · sharp · Cloudflare Workers
  11. ## Puesta en marcha
  12. Necesitas Node.js 22.12 o superior y pnpm.
  13. ```sh
  14. pnpm install
  15. pnpm dev
  16. ```
  17. La web queda en `http://localhost:4321`.
  18. | Comando | Qué hace |
  19. | :-- | :-- |
  20. | `pnpm dev` | Servidor de desarrollo con las marcas de contenido pendiente visibles |
  21. | `pnpm astro dev --background` | El mismo servidor en segundo plano. Se gestiona con `pnpm astro dev status`, `logs` y `stop` |
  22. | `pnpm build` | Genera la web estática en `dist/` |
  23. | `pnpm preview` | Sirve el build en local para revisarlo antes de publicar |
  24. ## Cómo funciona el paseo
  25. ```text
  26. 7 fotos reales ──► keyframes 16:9 ──► 6 clips (MiniMax H3) ──► ffmpeg ──► public/video/ ──► src/scripts/world.ts
  27. public/photos recorte/outpaint 1.er y último frame GOP 6 paseo-1…6.mp4 scrub con el scroll
  28. ```
  29. - **Seis paradas, seis tramos.** Cada parada de `paseo.paradas` (en `src/data/arko.ts`) tiene su clip, que va de ella a la siguiente. El clip de la última llega hasta el final de la sección. El texto de cada parada se queda fijo abajo a la izquierda mientras la cámara avanza.
  30. - **El scroll manda.** `world.ts` traduce la posición del scroll a un valor continuo (0 en la primera parada, 1 en la segunda, 2,5 a medio camino entre la tercera y la cuarta…) y fija el `currentTime` del clip activo. No hay reproducción: el vídeo solo avanza cuando haces scroll.
  31. - **Los pósters tapan la carga.** Bajo los vídeos está el primer fotograma de cada clip, sacado del propio MP4. Mientras un clip no ha cargado se ve su póster, y cuando entra el vídeo el cambio no se nota.
  32. - **Carga por cercanía.** Los clips se descargan de uno en uno: primero el del tramo actual y después el más cercano a la posición del scroll. Cada uno se baja entero como blob para que el scrub no dependa de la red.
  33. - **Móvil.** El 16:9 se recorta en vertical y el campo `focus` de cada parada decide qué parte horizontal queda a la vista.
  34. - **Sin vídeo cuando no toca.** Con `prefers-reduced-motion` o con ahorro de datos activo solo se ven los pósters.
  35. - **iOS.** Safari no pinta los fotogramas buscados hasta que el vídeo se ha reproducido una vez, así que cada clip hace un `play()` y un `pause()` al cargar.
  36. Lenis suaviza el scroll y está sincronizado con ScrollTrigger. Debajo del paseo, la página sigue con los platos destacados, la prensa, las experiencias, las preguntas frecuentes, la tarjeta regalo y la llamada final.
  37. ## Cómo se hizo
  38. El proceso completo, prompt a prompt, está en [`PROMPTS.md`](PROMPTS.md). En resumen:
  39. 1. **Primera versión** con la skill [`landing-page-design`](.claude/skills/landing-page-design/SKILL.md), usando solo datos verificados en arkorestaurant.com.
  40. 2. **Comparativa de modelos** con la misma transición (`3-mesas → 4-barra`) en Kling 3.0, MiniMax H3 y Seedance 2.0. Unos 64 créditos.
  41. 3. **Seis clips con MiniMax H3**, con la foto N como primer frame y la N+1 como último. Las fotos verticales se ampliaron a 16:9 con FLUX.2 Pro Outpaint. Clips de 8 s en 2K, bajados a 1080p. Coste: unos 137 créditos, unos 5 $.
  42. 4. **Montaje del scroll world** sobre el diseño, con un clip por tramo y carga priorizada.
  43. ## Estructura
  44. ```text
  45. src/
  46. ├── data/
  47. │ ├── arko.ts Todo el contenido: paradas, precios, platos, FAQ, contacto, enlaces y SEO
  48. │ ├── schema.ts JSON-LD de la portada: Restaurant, WebSite, WebPage y FAQPage
  49. │ └── imagenes.ts Imagen para redes y fotos con URL fija (JSON-LD y sitemap)
  50. ├── pages/
  51. │ ├── index.astro Landing (con el JSON-LD)
  52. │ ├── robots.txt.ts robots.txt con la URL del sitemap
  53. │ ├── llms.txt.ts Resumen en texto plano para asistentes de IA
  54. │ └── 404.astro
  55. ├── layouts/Layout.astro <head>: metas, Open Graph, Twitter Card y fuentes
  56. ├── components/
  57. │ ├── ScrollWorld.astro Escenario del paseo: pósters, clips, raíl de paradas y velos
  58. │ ├── Stop.astro Una parada del paseo
  59. │ ├── Pending.astro Marca de contenido pendiente (solo en desarrollo)
  60. │ └── … Secciones de la página, logo, iconos y espirales
  61. ├── scripts/
  62. │ ├── motion.ts Lenis, apariciones al hacer scroll y animaciones con GSAP
  63. │ └── world.ts Lógica del paseo: scrub, pósters y cola de carga
  64. ├── styles/global.css Tokens de Tailwind (colores, fuentes, curva) y utilidades
  65. └── assets/ Fotos, pósters del paseo, fuentes recortadas y logo
  66. public/
  67. ├── video/paseo-1…6.mp4 Clips del paseo, ya codificados para scrub
  68. ├── photos/ Fotos del local en JPG, enlazadas desde el JSON-LD y el sitemap
  69. ├── og-image.jpg Imagen para redes (1200×630)
  70. ├── site.webmanifest Manifest con los iconos icon-192.png e icon-512.png
  71. └── _headers Caché de un año para los archivos con hash de /_astro/
  72. ```
  73. La carpeta `media/` es el material de trabajo: pruebas de modelos, keyframes, masters en 2K y los prompts de cada clip. Git ignora los vídeos y las imágenes porque pesan mucho.
  74. ## Editar el contenido
  75. Los textos de la página viven en `src/data/arko.ts`, salvo el copy de las paradas, que está en `ScrollWorld.astro`. Arko es un negocio real, así que la regla es **no inventar nada**: ni reseñas, ni premios, ni platos, ni precios. Lo que no se ha podido verificar se marca con `<Pending>` o con el campo `pending`, y solo se ve con `pnpm dev`. Nunca llega al build.
  76. ## Cambiar un clip del paseo
  77. Para que el scrub sea fluido, cada clip necesita un keyframe cada pocos fotogramas (`-g 6`). Además, el color va marcado como BT.709 con curva sRGB: sin esa marca, el navegador pinta el vídeo más claro que el póster y el salto se nota.
  78. ```sh
  79. ffmpeg -i clip.mp4 -an -vf "scale=1920:-2" -c:v libx264 -preset slow -crf 28 \
  80. -g 6 -keyint_min 6 -sc_threshold 0 -pix_fmt yuv420p \
  81. -color_primaries bt709 -color_trc iec61966-2-1 -colorspace bt709 -color_range tv \
  82. -movflags +faststart+write_colr public/video/paseo-1.mp4
  83. ```
  84. Después regenera su póster a partir del primer fotograma, conviértelo a WebP y guárdalo en `src/assets/paseo/`:
  85. ```sh
  86. ffmpeg -i public/video/paseo-1.mp4 -frames:v 1 \
  87. -vf "scale=in_color_matrix=bt709:in_range=tv:out_range=pc,format=rgb24" paseo-1.png
  88. ```
  89. ## SEO
  90. - **Dominio:** `site` en `astro.config.mjs` es la URL pública. De ella salen el canonical, `og:url`, `og:image`, el JSON-LD, el sitemap y `robots.txt`, así que basta con cambiarla ahí.
  91. - **Metas:** título y descripción por página (los de la portada están en `seo`, en `src/data/arko.ts`), `robots` con `max-image-preview:large`, canonical con `hreflang` `es-ES` y `x-default`, y Open Graph y Twitter Card completos con la imagen `og-image.jpg`. No hay `twitter:site` porque Arko no tiene cuenta de X enlazada en su web. La 404 lleva `noindex`.
  92. - **Datos estructurados:** un solo grafo en `src/data/schema.ts` con `Restaurant` (dirección, coordenadas, horario, rango de precio, carta con los platos y las experiencias con su precio, y reserva), `WebSite`, `WebPage` y `FAQPage` con las preguntas frecuentes. Todo sale de `src/data/arko.ts`.
  93. - **Rastreo:** `@astrojs/sitemap` genera `sitemap-index.xml` sin la 404, con la imagen para redes y las fotos del local en la entrada de la portada. `robots.txt` lo enlaza. `llms.txt` resume el restaurante en texto plano.
  94. - **Peso:** el HTML de la portada pesa unos 105 KB (unos 27 KB comprimido). Las espirales y el logo van en línea, con los paths compactados.
  95. ## Despliegue
  96. Es una web estática que se sirve con Cloudflare Workers sin código de Worker. La configuración está en `wrangler.jsonc`.
  97. ```sh
  98. pnpm build
  99. pnpm dlx wrangler deploy
  100. ```
  101. ## Pendiente
  102. - Dominio final. Ahora `site` apunta a `arko-sushi.midudev.workers.dev`.
  103. - Fotos de los platos destacados. Cada plato ya tiene su hueco ovalado.
  104. - Validar con el restaurante el texto sobre alergias.
  105. - Política de cancelación y si las experiencias se piden al reservar o en la mesa.
  106. - Nota y número de reseñas de Google, verificados.
  107. ## Créditos
  108. - Fotos, logo y textos: © Arko Restaurant.
  109. - Fuentes: [Hina Mincho](https://fonts.google.com/specimen/Hina+Mincho) y [Zen Kaku Gothic New](https://fonts.google.com/specimen/Zen+Kaku+Gothic+New), bajo licencia SIL OFL (las licencias están junto a los archivos). Se sirven desde el propio dominio y están recortadas a latín.
  110. - Skills: [landing-page-design](https://github.com/elayadesign/ai-design-skills) y [scroll-world](https://github.com/oso95/scroll-world).
  111. - Vídeo: [Higgsfield](https://higgsfield.ai) con MiniMax H3 y FLUX.2 Pro Outpaint.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.