Generate goal bingo card
generate_goal_bingoRead-onlyIdempotent
Use this when the user wants a goal bingo card (new year goal bingo, 2027 bingo card, resolutions bingo, bucket-list bingo): one personal 5x5 card (or 4x4, 3x3) of their own goals with a free centre, title, year and theme colour, as a PNG, SVG and printable PDF. Goals marked completed print with a check mark and the tool counts bingo lines. Needs one goal per square (24 for 5x5 with a free centre). Does not invent goals for the user and does not make sets of party cards (use generate_bingo_cards).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| seed | No | Shuffle number from an earlier result to repeat the same order, e.g. 77. | |
| year | No | Year for the title, e.g. 2027 gives "2027 Bingo". | |
| goals | Yes | The goals, one per square, e.g. ["Run a 10K", "Read 12 books", "Learn to make sourdough"]. Exactly 24 for a 5x5 card with a free centre (25 without), 16 for 4x4, 8 for 3x3 with a free centre (9 without). Up to 80 characters each. | |
| paper | No | Paper size for the PDF, e.g. letter (default) or a4. | |
| title | No | Card heading, e.g. Maya's 2027 Bingo. Overrides the year title. | |
| shuffle | No | true to mix the goals into a random order, e.g. false (default keeps your order, filled row by row). | |
| subtitle | No | Small line under the title, e.g. One square at a time. | |
| completed | No | Goals already done, written as in goals, e.g. ["Read 12 books"]. They print with a check mark and count toward bingo lines. | |
| grid_size | No | 3, 4 or 5 (default 5), e.g. 5. | |
| free_space | No | Free centre square on 3x3 and 5x5 cards, e.g. true (default). | |
| accent_color | No | Theme colour as hex or a name, e.g. #0B7285, teal, gold, purple. Default raspberry #C2255C. | |
| center_label | No | Text in the centre square, e.g. FREE (default), Be kind to myself, or 2027. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| done | Yes | ||
| seed | Yes | ||
| view | Yes | ||
| cells | Yes | ||
| title | Yes | ||
| accent | Yes | ||
| subtitle | Yes | ||
| warnings | Yes | ||
| downloads | Yes | ||
| grid_size | Yes | ||
| done_count | Yes | ||
| goal_count | Yes | ||
| bingo_lines | Yes | ||
| center_index | Yes |