Guides
CakeShare
Securely share birthday lists with CakeShare
CakeShare is the sharing format used by Cakeday to move birthday data between devices.
Individual Sharing Modes
When viewing a friend’s profile, tapping the Share button provides two options:
- Share Link: Generates an encoded share link based on
https://cakeday.wbx1.com/share. It contains the person’s name, date, calendar type, leap month flag, year (if provided), and notes, but does NOT include the avatar or group assignment. When the recipient taps the link on an Apple device, Cakeday opens and shows an “Add Contact” prompt. Share links have limits: names up to 200 characters, notes up to 2,000 characters, and the total encoded payload cannot exceed 4 KB. - Share File (with avatar): Generates a
.cakesharefile for that person, including their compressed avatar photo.
Opening Share Links
When a recipient taps a share link, the behavior depends on their device and browser:
- Apple device (Safari or system browser): The link automatically attempts to open Cakeday. If the app is not installed, a fallback appears after a few seconds with a link to download Cakeday from the App Store.
- Apple device (in-app browser): In-app browsers (e.g. WeChat, QQ, LINE, Weibo) cannot open deep links directly. A guide is shown instructing the user to tap the menu and select “Open in Safari.”
- Non-Apple device: A message explains that the link requires an iPhone, iPad, or Mac. A link to the App Store is provided.
Share Package (.cakeshare)
When you need to share multiple friends (including avatars and groups), Cakeday generates a Share Package (.cakeshare).
File Protection
Exported .cakeshare files are protected before you share them.
- You can optionally add a password so the recipient must enter it before import.
- Only share files and passwords through channels you trust.
CakeShare Web Tool
A browser-based tool is available at https://cakeday.wbx1.com/cakeshare for creating .cakeshare packages without the iOS app. With the web tool you can:
- Add friends with names, dates (solar or lunar), groups with colors and icons, avatars, and notes.
- Import from CSV using a downloadable template.
- Crop and compress avatars to 1024px WebP (max 2 MB).
- Export a
.cakesharefile with optional password protection.
All data processing happens entirely in your browser. Nothing is uploaded to any server.
Inbound Decoding Flow
When a recipient opens a .cakeshare file, Cakeday shows the “Import Share Package” interface.
- A list of contacts is displayed, and you can select which ones to import.
- If a contact already exists, a duplicate warning is shown.