# BOILERPLATE.md — Canonical Company Boilerplates (25 / 50 / 100 words)

> Status: CANON v1.0 · adopted 2026-07-13 · derived from `strategy/POSITIONING.md` §6
>
> Owner: Aidin · Locales: en master + es / tr / fa transcreations (12 blocks)

---

## Source of truth, and where this file sits

The **single canonical boilerplate paragraph lives in `POSITIONING.md` §6** (65 words). When someone asks for "the boilerplate" with no length limit, send that paragraph verbatim. This file holds its **only sanctioned fixed-length derivatives** — the 25/50/100-word blocks below — for surfaces that impose a size. No other document may restate or re-derive the boilerplate; they link here or to POSITIONING §6.

Every block below ends with availability + `giftplanner.app`. English word counts are exact (`giftplanner.app` = one word); transcreations match meaning and register, not count — Spanish runs longer, Turkish agglutinates, Persian sets its own rhythm. That is correct and must not be "fixed".

---

## Which length for which ask

| Ask | Use | Why |
|---|---|---|
| Press-release footer ("About GiftPlanner") | **50** | The standard press-kit unit: full product walk, no biography. |
| Press page / media kit / journalist backgrounder / interview one-sheet | **100** | The only block that carries privacy engineering, founder, and languages — the three things journalists ask about first. |
| App directories, award entries, podcast show notes, partner blurbs, event listings with tight limits | **25** | The locked one-liner plus category label and availability — nothing to cut. |
| "Describe your app" field, one sentence only | Neither — use the **one-liner** from POSITIONING §6 | The boilerplate is a paragraph; the one-liner is the sentence. Different jobs. |
| Bio or header close | Neither — use the **tagline** ("Never miss a birthday. Always nail the gift.") | The tagline is the promise; the boilerplate is the fact-paragraph. Never substitute one for the other (POSITIONING §6 role split). |

**If a surface's limit falls between two lengths, use the next size DOWN in full. Never trim a block to fit.**

---

## English (master)

### 25 words

> GiftPlanner, the birthday gift planner, remembers every friend's birthday and turns what they actually love into gift ideas you can buy. iOS and Android. giftplanner.app

### 50 words

> GiftPlanner is the birthday gift planner that knows what your friends actually want. Add friends once; it remembers every birthday and, two weeks ahead, turns each friend's real interests into gift ideas you can buy — plus a custom cake design, birthday message, and digital postcard. On iOS and Android. giftplanner.app

### 100 words

> GiftPlanner is the birthday gift planner that knows what your friends actually want. Add the people you care about once; it remembers every birthday and, two weeks ahead, hands you gift ideas matched to each friend's real interests — with real products to buy — plus a custom cake design, a birthday message, and a digital postcard. Privacy is engineered, not promised: friends' names never reach image generators, and raw social data is never stored — only interest signals. GiftPlanner is built by a solo founder in Cyprus and is free to start. iOS and Android, in English, Spanish, Turkish, and Persian. giftplanner.app

**Derivation notes:** the 25 embeds the locked one-liner verbatim with the category label as an appositive; the 50 compresses POSITIONING §6's paragraph; the 100 extends it with Pillar 4's privacy proof (MESSAGE_HOUSE) and the founder fact. US spelling throughout — these are public copy. "Persian" in all external copy; "Farsi/fa" is internal only.

---

## Spanish (es) — transcreations

Register: **tú**, region-neutral (VOICE_TONE locale notes). Category label verbatim: **planificador de regalos de cumpleaños** (POSITIONING §2). "Pastel" and "postal digital" echo the shipped web copy in `translations.ts`.

### 25 palabras

> GiftPlanner, el planificador de regalos de cumpleaños, recuerda el cumpleaños de cada amigo y convierte lo que de verdad le encanta en ideas de regalo que puedes comprar. En iOS y Android. giftplanner.app

### 50 palabras

> GiftPlanner es el planificador de regalos de cumpleaños que sabe lo que tus amigos de verdad quieren. Añade a tus amigos una vez; recuerda cada cumpleaños y, con dos semanas de antelación, convierte los intereses reales de cada amigo en ideas de regalo que puedes comprar — además de un diseño de pastel personalizado, un mensaje de cumpleaños y una postal digital. En iOS y Android. giftplanner.app

### 100 palabras

> GiftPlanner es el planificador de regalos de cumpleaños que sabe lo que tus amigos de verdad quieren. Añade una sola vez a las personas que te importan; recuerda cada cumpleaños y, con dos semanas de antelación, te pone delante ideas de regalo basadas en los intereses reales de cada amigo — con productos reales para comprar — además de un diseño de pastel personalizado, un mensaje de cumpleaños y una postal digital. La privacidad está en el código, no en las promesas: los nombres de tus amigos nunca llegan a los generadores de imágenes y nunca guardamos datos sociales en bruto, solo señales de interés. GiftPlanner es obra de un solo fundador en Chipre y empezar es gratis. En iOS y Android, en inglés, español, turco y persa. giftplanner.app

---

## Turkish (tr) — transcreations

Register: **sen**, consistently (VOICE_TONE locale notes — *siz* sounds like a bank). Category label verbatim: **doğum günü hediyesi planlayıcısı** (POSITIONING §2). "Pasta" and "dijital kartpostal" echo the shipped web copy. No ™ symbol on tr surfaces (NAMING).

### 25 kelime

> Doğum günü hediyesi planlayıcısı GiftPlanner, bütün arkadaşlarının doğum günlerini hatırlar ve gerçekten sevdikleri şeyleri, satın alabileceğin hediye fikirlerine dönüştürür. iOS ve Android'de. giftplanner.app

### 50 kelime

> GiftPlanner, arkadaşlarının gerçekten ne istediğini bilen doğum günü hediyesi planlayıcısı. Arkadaşlarını bir kez ekle; her doğum gününü hatırlar ve iki hafta önceden, her arkadaşının gerçek ilgi alanlarını satın alabileceğin hediye fikirlerine dönüştürür — üstelik kişiye özel bir pasta tasarımı, doğum günü mesajı ve dijital kartpostalla birlikte. iOS ve Android'de. giftplanner.app

### 100 kelime

> GiftPlanner, arkadaşlarının gerçekten ne istediğini bilen doğum günü hediyesi planlayıcısı. Önem verdiğin insanları bir kez ekle; her doğum gününü hatırlar ve iki hafta önceden, her arkadaşının gerçek ilgi alanlarıyla eşleşen hediye fikirlerini önüne koyar — satın alabileceğin gerçek ürünlerle birlikte — üstelik kişiye özel bir pasta tasarımı, doğum günü mesajı ve dijital kartpostalla. Gizlilik vaatte değil, kodda: arkadaşlarının isimleri görsel oluşturuculara asla gönderilmez, ham sosyal veri asla saklanmaz — yalnızca ilgi sinyalleri tutulur. GiftPlanner'ı Kıbrıs'ta tek bir kurucu geliştiriyor; başlamak ücretsiz. iOS ve Android'de; İngilizce, İspanyolca, Türkçe ve Farsça. giftplanner.app

---

## Persian (fa) — transcreations

Register: warm **تو** — press boilerplate is a marketing surface under the two-surface rule (canon in VOICE_TONE / MESSAGE_HOUSE / PITCHES). Category label verbatim: **برنامه‌ریز هدیه تولد** (POSITIONING §2; inflects normally in running grammar, e.g. «برنامه‌ریزِ هدیه‌ی تولدی است که…»). Persian punctuation (، ؛); brand name stays Latin, at most once per block — the 100-word block's second mention becomes «این اپ» (NAMING + VOICE_TONE RTL rules). «کیک» and «کارت‌پستال» echo the shipped web copy. No ™ symbol on fa surfaces.

### ۲۵ کلمه

> ‏GiftPlanner، برنامه‌ریز هدیه تولد، تولدِ همه‌ی دوستانت را یادش می‌ماند و از علاقه‌های واقعی‌شان ایده‌های هدیه‌ای می‌سازد که می‌توانی بخری. برای iOS و Android. giftplanner.app

### ۵۰ کلمه

> ‏GiftPlanner برنامه‌ریزِ هدیه‌ی تولدی است که می‌داند دوستانت واقعاً چه می‌خواهند. دوستانت را یک بار اضافه کن؛ همه‌ی تولدها را یادش می‌ماند و دو هفته زودتر، علاقه‌های واقعی هر دوست را به ایده‌های هدیه‌ای تبدیل می‌کند که می‌توانی بخری — به‌علاوه‌ی طرح کیک سفارشی، پیام تولد و کارت‌پستال دیجیتال. برای iOS و Android. giftplanner.app

### ۱۰۰ کلمه

> ‏GiftPlanner برنامه‌ریزِ هدیه‌ی تولدی است که می‌داند دوستانت واقعاً چه می‌خواهند. آدم‌های مهم زندگی‌ات را یک بار اضافه کن؛ همه‌ی تولدها را یادش می‌ماند و دو هفته زودتر، ایده‌های هدیه‌ای متناسب با علاقه‌های واقعی هر دوست جلویت می‌گذارد — همراه با محصولات واقعی برای خرید — به‌علاوه‌ی طرح کیک سفارشی، پیام تولد و کارت‌پستال دیجیتال. حریم خصوصی وعده نیست، در کد ساخته شده: اسم دوستانت هرگز به مولدهای تصویر نمی‌رسد و داده‌ی خام شبکه‌های اجتماعی هرگز ذخیره نمی‌شود — فقط سیگنال‌های علاقه می‌ماند. این اپ ساخته‌ی یک بنیان‌گذارِ تنها در قبرس است و شروعش رایگان است. برای iOS و Android؛ به انگلیسی، اسپانیایی، ترکی و فارسی. giftplanner.app

---

## The availability line — the ONE sanctioned substitution

The blocks above state store availability ("iOS and Android"), which is true **from launch day**. Until the apps are live in both stores, every placement swaps ONLY the final availability sentence for the pre-launch line below — nothing else in the block changes (word counts drift; that is fine, this is the one exception):

| Locale | Pre-launch availability line |
|---|---|
| en | Launching on iOS and Android — join the waitlist at giftplanner.app |
| es | Muy pronto en iOS y Android — únete a la lista de espera en giftplanner.app |
| tr | Çok yakında iOS ve Android'de — bekleme listesine katıl: giftplanner.app |
| fa | به‌زودی برای iOS و Android — در فهرست انتظار ثبت‌نام کن: giftplanner.app |

**[operator: on store launch day, flip every live placement (press page, media kit, distributed releases) from the pre-launch line back to the standard blocks — one sweep, same day.]**

---

## Rules of use

1. **Do not edit ad hoc. Ever.** These twelve blocks are canon, letter for letter — punctuation, em-dashes, and the closing `giftplanner.app` included. No trimming to fit a field, no "quick improvement", no re-translation, no mixing sentences between lengths. If a block doesn't fit, use the next size down in full. If a block needs to *change*, see Change control below.
2. **Three strings, three jobs** (POSITIONING §6): the tagline is the promise, the one-liner is the fact, the boilerplate is the paragraph. None substitutes for another; the boilerplate never closes with the tagline bolted on.
3. **The AI rule holds** (POSITIONING §5 is the sole AI rule): no "AI-powered", no "AI" anywhere in these blocks or added around them. The category is "birthday gift planner", verbatim, in the fixed locale renderings.
4. **™ symbol** (NAMING): if the boilerplate is the first prominent use of the name on a surface, the first "GiftPlanner" may carry ™ — once per surface, en/es only; tr/fa omit symbols entirely. ® is forbidden until a registration issues. The blocks are stored clean; the surface adds the ™.
5. **Name rules** (NAMING): "GiftPlanner" in prose everywhere — never "GiftPlannerAI" in a boilerplate (store display name only). The URL prints lowercase, no `https://`, no `www`. Brand name stays Latin in all four locales.
6. **Languages and locales:** these four locales are the only approved versions. No machine translation into other languages — any new locale (including ru) is transcreated through this brief and added here first. Say "Persian", never "Farsi", in English-language copy.
7. **[operator: language enumeration caveat]** — the 100-word blocks enumerate "English, Spanish, Turkish, and Persian" per POSITIONING §6, which is subject to the §2 standing caveat: the app bundle contains `ru.ts` and the ship/drop decision is open. If Russian ships in the app, update the enumeration in all four 100-word blocks here AND in POSITIONING §6 in the same commit. Until then, never convert the enumeration into a hard count ("in four languages") anywhere in press copy.
8. **Truth boundaries baked in:** "free to start" is the only pricing claim (weekly caps and the $4.99/mo tier live in product/store copy, not the boilerplate — and the annual price is [operator: verify in RevenueCat] before it appears anywhere). The claim-profile loop is built but not deployed and is deliberately absent from these blocks — do not add it.
9. **Media contact** is not part of the boilerplate. In press releases it sits on its own line after the block: `Press: press@giftplanner.app`.

---

## Change control

The boilerplate changes in exactly one way: **edit the canonical paragraph in `POSITIONING.md` §6 first**, then re-derive all twelve blocks here in the same commit, re-vetting the three transcreations with a native speaker (transcreate, never translate — MESSAGE_HOUSE rule 6). A change that touches one block touches all twelve. Product changes flow product → MESSAGE_HOUSE → POSITIONING §6 → here — never the other way round.

**English word-count discipline:** the en blocks count exactly 25, 50, and 100 words (`giftplanner.app` = 1 word; em-dash phrases counted word by word). Preserve exactness on any future revision — journalists and directories take these counts at face value.
