kawaii-shuffle help
Every option is a path segment after https://readmes.pages.dev/kawaii-shuffle/, in any order. Use the builder, then paste the result into your README.
URL builder
The builder runs in your browser; nothing you choose is sent anywhere except the preview image request.
Preview
All options
A trailing .svg is allowed and case is ignored. An unknown option renders a small error badge that names its position, for example unknown option #2
.
What to show
| Option | Effect |
|---|---|
random | A random picture on every load (default). |
daily | One picture per day, changing at 00:00 UTC. Cacheable until then. |
cycle | Animated crossfade slideshow of all pooled pictures, in shuffled order. |
miko, doujin, pale, hanten, jinbei | Pick pictures by name. One name always shows it; several names form the pool to shuffle. |
speed-N | Seconds per picture in cycle mode, 2 to 30 (default 4). |
Shape and size
| Option | Effect |
|---|---|
rounded | Rounded-corner card (default). |
rect | Square corners. |
circle | Circle avatar; forces the square aspect. |
polaroid | Instant-photo frame with a caption. |
wide, banner, square, portrait | Aspect ratio 16:9 (default), 3:1, 1:1 or 3:4. |
size-N | Width in pixels, 64 to 800 (default 400; 200 for square and portrait). |
border-N | Border width in pixels, 0 to 16 (default 0). |
Look and feel
| Option | Effect |
|---|---|
auto | Follow the viewer's light or dark preference (default). |
light, dark | Force a theme. |
transparent | No background; frame colors still follow the viewer's preference. |
accent-RRGGBB | Border and sparkle color as 3 or 6 hex digits without #, e.g. accent-e91e63. |
label, nolabel | Show or hide the picture name (polaroid shows it by default). |
sparkles | Add twinkling sparkles. |
Caching on GitHub
GitHub serves README images through its camo proxy. Random badges are sent with no-store so a new picture is usually fetched, but a browser may still repeat one. Use cycle to guarantee every picture is seen. daily and single-picture URLs are cached on purpose.
Your own pictures
This demo never accepts uploads. Copy the template repository, add your pictures and deploy it to your own free Cloudflare Pages project. The README has step-by-step instructions.