Przejdź do treści
Biblioteka skilli
Projektowanie i UX · Budowanie i kod

frankaa

/frankaa

Dodaje lub naprawia suwaki zdjęć i podglądy pełnoekranowe w pakiecie frankaa, w tym karuzele z przesuwaniem, lightboxy i przejścia GLSL.

Repozytorium
frankaa ↗
Licencja
MIT
Ostatnia zmiana repozytorium
13.11.2026

Ocena i bezpieczeństwo

90/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść25 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Dodaje lub naprawia suwaki zdjęć i podglądy pełnoekranowe w pakiecie frankaa, w tym karuzele z przesuwaniem, lightboxy i przejścia GLSL.

Oryginalny opis (EN)

Add or fix photo sliders and photo lightboxes with the frankaa package (procession slider, unfurl lightbox, React bindings, WebGL or CSS renderer, custom GLSL transition shaders). Use when a project needs a swipeable photo carousel, a listing-card photo slider, a gallery grid that opens a fullscreen lightbox, image transition effects, or when frankaa is already a dependency.

Jak działa

  1. Steps
  2. Decisions
  3. Checklist
Sekcje z nagłówków SKILL.md, w oryginale · 38 linii, 469 słów
Podgląd SKILL.md
---
name: frankaa
description: Add or fix photo sliders and photo lightboxes with the frankaa package (procession slider, unfurl lightbox, React bindings, WebGL or CSS renderer, custom GLSL transition shaders). Use when a project needs a swipeable photo carousel, a listing-card photo slider, a gallery grid that opens a fullscreen lightbox, image transition effects, or when frankaa is already a dependency.
---

# frankaa

frankaa is a zero-dependency photo slider (`procession`) and lightbox (`unfurl`) with thin React bindings. Full reference: `node_modules/frankaa/llms-full.txt` (read it before writing code). Agent rules: `node_modules/frankaa/AGENTS.md`.

## Steps

1. Install: `npm install frankaa` (explain to the person that it is a runtime dependency with no dependencies of its own).
2. Import the styles once: `import "frankaa/style.css"`.
3. Pick the import: `frankaa/slider`, `frankaa/lightbox`, `frankaa` (both) or `frankaa/react`.
4. Wire it:
   - Slider: `procession(element, { photos, label })`, or `<Procession photos label ref />` in React.
   - Lightbox: `unfurl({ photos, start, origin: (n) => thumbElement(n) })`, or `useUnfurl(photos, { origin })` then `open(i)`.
   - Slider opening the lightbox: `onSelect: (i) => unfurl({ photos, start: i, origin: (n) => slider.image(n), onChange: (n) => slider.go(n, false) })`.
5. In Next.js or any SSR framework, use it only in client components and never at module top level.
6. Verify with the checklist below.

## Decisions

- `renderer: "auto"` (default). Use `"css"` for cross-origin photos without CORS headers, or when WebGL is unwanted.
- Effects: `"displacement"` (default), `"ripple"`, `"fade"`, `"zoom"`, `"none"`, or a custom shader.
- Custom shader: GLSL ES 1.0 fragment with `precision mediump float;`, `vUv`, `uFrom`, `uTo`, `uProgress`, `uResolution`, `uFromSize`, `uToSize`, `uTime`, `uDirection`, own uniforms; output `gl_FragColor`; macros `coverUv()` and `mirrorUv()`. Register with `registerEffect(name, { fragment, uniforms })`, check with `checkEffect()`. Compile errors fire `onError` and fall back to CSS. Never compile shader source from users.
- Videos: items `{ type: "video", provider: "youtube" | "vimeo" | "tiktok" | "instagram" | "mp4", src, poster }`; players load on tap; add providers to CSP `frame-src`.
- Extra top-bar buttons: `topActions` or `controls`; React `renderControls` and render `{lightbox.portal}`. Never inject into the dialog by DOM query.
- `destroy()` fires the close hooks with `reason: "destroy"`.
- Zoom is on in the lightbox (pinch, double tap, Ctrl+wheel); slider zoom is opt-in (`zoom: true`). Slider links: `href`, `tabbable: false`, `focusRing: "inset"` in clipped cards. Theme with `--fk-*` properties.
- One items list for every part: `{ src, thumb?, full?, alt }`. Combining is one option: `unfurl(items, { strip: "ruler" })`; `drumline(el, items, { preset })` opens the lightbox on tap. React: `<Drumline items preset />`, `useUnfurl(items, { strip })`.
- drumline presets "ruler" | "numbers" | "minimal"; `fluid` "off" | "lerp" | "chain" | "bend" (WebGL with a DOM fallback).
- Autoplay off, `reducedMotion: "system"`, unless the person asks.
- Translate with `labels` (`{n}` and `{total}` placeholders).
- Listen with hooks (`onOpenStart`, `onOpenEnd`, `onCloseStart`, `onCloseEnd`, `onChange`, `onSlideChange`, `onAnimationStart`, `onAnimationEnd`, `onError`) or DOM events `frankaa:<kebab-name>`.

## Checklist

- Styles imported; slider has an aspect ratio or height (no layout shift); photos have `alt`, `width`, `height`.
- Keyboard: slider arrows and Enter; lightbox arrows, Escape, Tab trapped, focus returns on close.
- Reduced motion gives a fade; thumbnails spring out and back; no console errors or `frankaa:error` events.

Wersje

W bazie nie ma innych skilli o nazwie frankaa.

Migawka bazy z 13.11.2026 · wersja paczki 1e3d8badb0c0 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100gpuslider
    Dodaje slider, karuzelę, galerię lub lightbox obrazów i wideo z przejściami na shaderach GPU (liquid, burn, glitch) w czystym JS, React i Next.js.
  • 90carousel
    Projektuje, optymalizuje i audytuje karuzele i slidery do treści: galerie, opinie, cytaty i dostępność.
  • 95image-sphere
    Buduje w three.js kulę ze zdjęciami, które dryfują, obracają się po przeciągnięciu i po kliknięciu powiększają wybrane zdjęcie w podglądzie.
  • 91apple-hig-sliders
    Pomaga projektować suwaki do ciągłej regulacji: skale, precyzyjne wpisywanie wartości i podgląd na żywo.
  • 100fe-a11y-carousel-toast
    Buduje karuzele, suwaki treści i powiadomienia, które można zatrzymać, obsłużyć z klawiatury i usłyszeć, zgodnie ze wzorcami WAI-ARIA.
  • 100gallery
    Tworzy galerie zdjęć z kuracją układu wspomaganą przez AI, koordynując skrypty i subagenty.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.