Skip to content
Back to search

wish-site

SkillWorks with Claude CodeGitHub

Build a cute, animated, mobile-friendly celebration website (birthday, anniversary, graduation, wedding…) for someone special — themed colours, a cat/bunny/bear character, number candles you can blow out, 3D photo carousel, draggable polaroids, tap-the-hearts messages, scrapbook and a 3D photo world. Use when the user wants to make a birthday/wish/greeting website, a surprise page for a friend or partner, or asks for "a cute website with photos and messages".

Safety scan

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

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ashishbhoure--wish-site/badge.svg)](/listings/ashishbhoure--wish-site)

HTML

<a href="/listings/ashishbhoure--wish-site"><img src="/api/listings/ashishbhoure--wish-site/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.

SKILL.md · Manifest · 83 lines
  1. ---
  2. name: wish-site
  3. description: Build a cute, animated, mobile-friendly celebration website (birthday, anniversary, graduation, wedding…) for someone special — themed colours, a cat/bunny/bear character, number candles you can blow out, 3D photo carousel, draggable polaroids, tap-the-hearts messages, scrapbook and a 3D photo world. Use when the user wants to make a birthday/wish/greeting website, a surprise page for a friend or partner, or asks for "a cute website with photos and messages".
  4. ---
  5. # wish-site
  6. Generates a static, zero-build celebration website from a template. No framework, no server — just
  7. `index.html` + `config.js` + photos, so it can be hosted free anywhere (GitHub Pages, Cloudflare Pages, Netlify, Vercel).
  8. Everything personal lives in **one file: `config.js`**. This skill's job is to collect the details,
  9. fill `config.js`, prepare the photos, preview, and (if asked) deploy.
  10. Paths below are relative to this skill's folder (the one containing this SKILL.md).
  11. ## Workflow
  12. ### 1. Gather details (ask only what's missing, in one short message)
  13. - **Whose site / who from** → `name`, `from`
  14. - **Occasion** → `occasion` (two title lines, e.g. `["Happy","Birthday"]`, `["Happy","Anniversary"]`, `["Congrats","Graduate"]`). Use their language if not English.
  15. - **Number** → `number` (age / years, e.g. `"23"`; `""` gives a heart candle)
  16. - **Theme** → `theme`: `lavender | rose | mint | sky | peach | sunshine | berry`, or custom `{ primary:"#hex", secondary:"#hex" }`. If the user says a colour ("blue and gold"), pick the closest preset or build a custom pair of *pastel* colours.
  17. - **Character** → `character`: `cat | bunny | bear | none`
  18. - **Photos folder** (optional — without photos the site shows cute placeholders)
  19. - **Messages** (optional) — wishes, letter, card captions. If the user wants help, draft warm, specific, non-generic text from what they tell you about the person (inside jokes, hobbies). Keep each wish under ~70 characters. Match their language/tone (Hinglish etc. is fine).
  20. Don't invent personal facts. If you don't know something, use the neutral defaults already in `config.js`.
  21. ### 2. Create the site
  22. ```bash
  23. node scripts/init.mjs <new-site-folder>
  24. ```
  25. Then edit `<new-site-folder>/config.js` (see "Config reference").
  26. ### 3. Photos
  27. Ask the user to point at a folder of photos, then:
  28. ```bash
  29. # optional but recommended (resizes for phones, fixes rotation):
  30. cd scripts && npm install && cd ..
  31. node scripts/prepare-photos.mjs "<their-photos-folder>" "<new-site-folder>/photos" --max 24
  32. ```
  33. This writes `photos/pNN.jpg` and `photos/manifest.js`. Photos are used everywhere automatically
  34. (hero, carousel, polaroids, scrapbook, 3D world).
  35. - **Look at the photos yourself** (contact sheet or sample) when the user wants curation: prefer clear, solo, flattering shots; skip screenshots, blurry or private-looking images, and ask before using anything sensitive.
  36. - Make sure `heroPhoto` / `cards[].img` names exist in `photos/`.
  37. ### 4. Preview & verify
  38. ```bash
  39. node scripts/serve.mjs <new-site-folder> # http://localhost:8080/#open (#open skips the gift screen)
  40. ```
  41. Check on a **phone-width viewport (≈390px)**: no sideways scroll, text not clipped, photos load. Fix `config.js`, not the engine, unless it's a real bug.
  42. ### 5. Deploy (only if the user asks; confirm before publishing)
  43. Free static hosting. **GitHub Pages needs a public repo → the photos become publicly reachable; tell the user.** Offer Cloudflare Pages/Netlify (can be unlisted) if they care.
  44. ```bash
  45. cd <new-site-folder> && git init -b main && git add -A && git commit -m "wish site"
  46. gh repo create <repo-name> --public --source=. --push
  47. gh api -X POST repos/<user>/<repo-name>/pages -f "source[branch]=main" -f "source[path]=/"
  48. # live in ~1 min at https://<user>.github.io/<repo-name>/
  49. ```
  50. Updates later: `git add -A && git commit -m update && git push`.
  51. ## Config reference (`config.js`)
  52. | key | what it does |
  53. |---|---|
  54. | `name`, `from` | who it's for / who signs the letter |
  55. | `occasion` | `["Happy","Birthday"]` — big title + bunting flags |
  56. | `number` | number candles; `""` → heart candle |
  57. | `theme` | preset name or `{primary, secondary}` hex pair |
  58. | `character` | `cat`, `bunny`, `bear`, `none` |
  59. | `music` | soft music-box tune on/off (user can mute) |
  60. | `sections` | toggle `candles, gallery, cards, wishes, scrapbook, world, letter` |
  61. | `photos`, `heroPhoto` | auto from `photos/manifest.js`; override by hand if needed |
  62. | `cards` | `[{img, cap, msg}]` draggable polaroids (auto-built from photos if empty) |
  63. | `wishes` | up to 8 messages for the tap-the-hearts game |
  64. | `letter` | final letter body |
  65. | `text` | **every** label/sentence on the page (use `{name}`); translate the whole site here |
  66. ## Rules of thumb
  67. - Edit only `config.js` and `photos/` for a normal request. `app.js`, `style.css`, `themes.js` are the engine; change them only to fix a bug or add a feature (then add it to the template, not a one-off copy, if it's generally useful).
  68. - Keep the personality: cute, soft, pastel, lots of tiny animation. Don't make it corporate.
  69. - Never put someone's photos or details into a public repo/skill without the user's say-so.
  70. - Add new themes in `template/themes.js` (`PRESETS`), new characters in `cat()` in `template/app.js`.
README.md · README · 67 lines
  1. # 🎂 wish-site
  2. Make a **cute, animated, phone-friendly celebration website** for someone you love — in minutes.
  3. Birthday, anniversary, graduation, wedding… pick a colour theme, a little character, add your photos and
  4. your own messages. No framework, no build step, free to host.
  5. **What's inside the website**
  6. - 🎁 Gift-box intro with confetti + a music-box "Happy Birthday" tune
  7. - 🎈 Floating balloons you can pop, sparkle trail, cute character that meows when tapped
  8. - 🕯️ **Number candles** (her age!) — tap, or really *blow into your mic* to put them out
  9. - 🖼️ 3D swipe carousel · draggable & flippable **polaroid cards** · tap-the-hearts messages
  10. - 📒 Scrapbook page · 💌 final letter
  11. - 🌌 **3D photo world** — drag to look around, pinch to zoom, tap a photo to enlarge (three.js)
  12. - 🎨 7 themes (+ your own two colours) · 🐱🐰🐻 characters · every word editable (any language)
  13. **Live demo:** https://ashishbhoure.github.io/wish-site-demo/ · [mint + bunny](https://ashishbhoure.github.io/wish-site-demo/?theme=mint&character=bunny) · [sunshine + bear](https://ashishbhoure.github.io/wish-site-demo/?theme=sunshine&character=bear) · [peach + cat](https://ashishbhoure.github.io/wish-site-demo/?theme=peach)
  14. ## Use it with Claude Code (recommended)
  15. ```bash
  16. git clone https://github.com/ashishbhoure/wish-site ~/.claude/skills/wish-site
  17. ```
  18. Then in Claude Code just say: *"make a birthday website for my friend Riya, mint theme with a bunny, photos are in D:\photos\riya"*.
  19. Claude asks what's missing, fills the config, prepares the photos, previews it and can deploy it for you.
  20. ## Use it by hand
  21. ```bash
  22. node scripts/init.mjs my-site # copy the template
  23. # edit my-site/config.js (name, age, theme, character, messages…)
  24. cd scripts && npm install && cd .. # optional: enables photo resizing
  25. node scripts/prepare-photos.mjs ~/photos/riya my-site/photos
  26. node scripts/serve.mjs my-site # preview → http://localhost:8080/#open
  27. ```
  28. Upload the `my-site` folder to any static host (GitHub Pages, Cloudflare Pages, Netlify, Vercel).
  29. Only Node 18+ is needed; `sharp` is optional.
  30. ## Make it yours
  31. Everything is in `config.js`:
  32. ```js
  33. name: "Riya", from: "Sam", number: "23",
  34. occasion: ["Happy", "Birthday"], // or ["Happy","Anniversary"], ["Congrats","Graduate"]…
  35. theme: "mint", // lavender rose mint sky peach sunshine berry
  36. theme: { primary: "#7fd8b8", secondary: "#ffb3c7" }, // …or your own
  37. character: "bunny", // cat bunny bear none
  38. wishes: ["You make ordinary days special 🌷", "…"],
  39. text: { galleryTitle: "Yaadon ki gali", … } // translate every label
  40. ```
  41. Preview any theme/character without editing: add `?theme=berry&character=bear&number=30` to the URL.
  42. ## Add a theme or character
  43. - Theme → add a `{primary, secondary}` pair to `PRESETS` in `template/themes.js`.
  44. - Character → add a branch to `cat()` in `template/app.js` (ears + colours are tiny SVG).
  45. ## Privacy
  46. Photos in a public GitHub repo are public. For a surprise that should stay private, host on a
  47. service that allows unlisted sites, or share only the link with the person.
  48. ## License
  49. MIT — see [LICENSE](LICENSE). Contributions (themes, characters, languages, sections) welcome 💜

Ratings and comments

Sign in to rate this skill.

Sign in

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