Files
pezkuwi-wallet-android/BRAND.md
T
pezkuwichain 22422c85da Redesign: brand-book alignment + forbidden-color purge (v1.1.0) (#3)
* redesign(colors): purge forbidden magenta/purple from palette

Brand book permits only the Kurdistan palette (kesk/sor/zer/fire) + navy.
Replace the four Nova-legacy violations in common colors.xml (names preserved,
so no references break):
- crowdloan_banner_gradient_start  #BD387F -> #009639 (kesk)
- networks_banner_gradient_end     #661D78 -> #017A2F (kesk-700)
- chip_on_card_background           #443679 -> #3D999EC7 (frosted periwinkle)
- button_wallet_connect_background  #353D67 -> #1F2A4D (neutral navy)

Repo-wide grep confirmed no other hardcoded magenta/purple literals or
purple/pink-named resources remain.

* redesign(type): adopt brand fonts (Space Grotesk / Plus Jakarta Sans / JetBrains Mono)

Brand book typography. Add OFL static fonts under common/res/font and repoint
the theme font attrs (consumed app-wide via ?attr/font* in styles.xml):
- fontRegular     -> Plus Jakarta Sans Regular (body/UI)
- fontSemiBold    -> Plus Jakarta Sans SemiBold
- fontBold/ExtraBold -> Space Grotesk Bold (display: balances, titles)
- fontExtraLight  -> Plus Jakarta Sans Light
- Monospace text appearance (addresses/hashes) -> JetBrains Mono

Static TTFs chosen (minSdk 24 < variable-font API 26). All five verified to
cover Turkish + Kurdish Kurmancî glyphs (ş ğ ı İ ê î û ç …).

* redesign(splash): replace map+wordmark logo with Newroz flame brand mark

The first-launch splash logo (ic_loading_screen_logo) showed a Kurdistan map
with a baked-in wordmark. Per the brand book the mark is the Newroz flame.
Rasterized assets/nevroz-fire-flame.svg into the existing 6 density slots
(same pixel dimensions = drop-in, no bg_splash.xml change, transparent WebP so
it composites cleanly over the splash background).

* redesign(onboarding): welcome hero -> Global United States of Pezkuwi

Replace the legacy onboarding hero (ic_create_wallet_background, whose six
density PNGs had inconsistent broken dimensions) with the brand 'Global United
States of Pezkuwi' infographic. Consolidate to a single high-res WebP in
drawable-nodpi (1408x768, 204K vs 1.75MB PNG) and switch the welcome ImageView
scaleType centerCrop -> fitCenter so it shows full and uncropped above the
CTA buttons, per the brand book.

* redesign(assets): purge magenta/purple from raster illustrations

colors.xml only covers named colors; these raster drawables still carried
forbidden magenta/purple/pink pixels. Selectively rotate the 255-350 deg hue
band (purple-magenta-pink) toward kesk green/teal across all densities,
preserving gradients, shapes and the on-brand blues:
- ic_pink_siri, ic_networks_banner_image, ic_no_added_networks,
  ic_import_option_hardware, tinder_gov (6 densities each).
Third-party ic_powered_by_oak (OAK Network trademark) left untouched.
crowdloan_banner_image is being handled separately.

* redesign(assets): de-pink crowdloan banner across all densities

The crowdloan banner's magenta sphere was recolored to brand sor red (xxxhdpi).
Propagate that fix to the other five densities by downscaling the corrected
xxxhdpi master (LANCZOS), so every device shows the same brand-clean banner.
Pink-pixel scan now 0% on all six variants.

* chore: remove pre-production debug code (release-blocker)

CHANGELOG_PEZKUWI listed debug code to strip before production; two items were
still live:
- FeeLoaderV2Provider: the fee-retry dialog showed a raw "DEBUG: <err> | Runtime:
  <diagnostics>" string to users -> reverted to the localized resource string and
  dropped the diagnostics lookup.
- RuntimeFactory: removed the companion lastDiagnostics field and its assignment
  (plus the now-dangling diagnostic vars), and the matching log line in the
  PezkuwiLiveTransferTest androidTest.
Items #3-#6 were already clean. Repo now has no 'DEBUG:' literals or
lastDiagnostics references. CHANGELOG marked cleaned.

* docs: add BRAND.md — enforceable wallet brand rules

Kurdistan-only palette (no pink/magenta/purple), brand fonts, Newroz flame mark,
a PR brand checklist with a raster pink-scan snippet, the third-party-logo
exception, and the Apache-2.0 attribution rule (keep LICENSE/NOTICE). Points to
the canonical brand book at wiki.pezkuwichain.io/brand.

* release: bump versionName to 1.1.0 (brand-book UI redesign)

Live Play version is 1.0.4; minor bump for the UI redesign. versionCode stays
CI-managed (CI_BUILD_ID). Add the v1.1.0 entry to CHANGELOG_PEZKUWI.
2026-06-14 22:20:33 -07:00

90 lines
3.9 KiB
Markdown

# Pezkuwi Wallet — Brand Rules
This wallet must stay aligned with the **Pezkuwi brand book**. The canonical,
ecosystem-wide source of truth lives on the wiki:
**https://wiki.pezkuwichain.io/brand/**. This file is the wallet-specific,
enforceable summary — read it before changing any colors, fonts, or imagery.
## The one hard rule
> **Only the Kurdistan palette (kesk green, sor red, zer gold, fire orange) plus
> navy/neutral are allowed. Pink, magenta and purple are FORBIDDEN — anywhere.**
This applies to XML colors, Compose `Color(0x…)` literals, vector drawables,
gradients, **and raster images** (PNG/WebP banners and illustrations).
## Palette (source of truth)
| Token | Hex | | Token | Hex |
|-------|-----|-|-------|-----|
| kesk (primary) | `#009639` | | base bg | `#05081C` |
| kesk-700 | `#017A2F` | | screen bg | `#08090E` |
| positive | `#2FC864` | | elevated | `#181920` |
| sor (red) | `#E2231A` | | nav | `#0F111A` |
| negative | `#E53450` | | text primary | `#E0FFFFFF` |
| zer (gold) | `#FDB813` | | text secondary | `#7AFFFFFF` |
| warning | `#EBC50A` | | text tertiary | `#52FFFFFF` |
| fire (orange) | `#FF7A00` | | periwinkle tint | `#999EC7` @ 10/16/24% |
| info | `#2AB0F2` | | | |
## Typography
- **Space Grotesk** — display: balances, screen titles, large numbers
- **Plus Jakarta Sans** — body / UI text
- **JetBrains Mono** — addresses, hashes, block numbers
All three are OFL-licensed and cover Latin-ext / Turkish / Kurdish Kurmancî
glyphs. Fonts live in `common/src/main/res/font/`; the theme maps them via
`fontRegular/SemiBold/Bold/ExtraBold/ExtraLight` in `common/.../values/themes.xml`.
## Brand mark & imagery
- The brand mark is the **Newroz flame** (`nevroz-fire-*`). Do **not** use the
retired Roj-rosette mark or a Kurdistan-map logo anywhere.
- First-launch splash uses the Newroz flame (`ic_loading_screen_logo`).
- Onboarding hero uses the **Global United States of Pezkuwi** infographic.
- Pull chain/token/dapp icons from `pezkuwichain/pezkuwi-wallet-utils`, don't
invent art. Keep one outline icon set (2px stroke, round caps).
## Where colors are defined
- Named colors: `common/src/main/res/values/colors.xml`
- Theme/type: `common/src/main/res/values/themes.xml`, `styles.xml`
## PR checklist (brand)
- [ ] No magenta/purple/pink in `colors.xml` (`#BD387F`, `#661D78`, `#443679`, `#FF48A5`, …).
- [ ] No `purple`/`magenta`/`pink`-named drawables or Compose color literals.
- [ ] Raster assets scanned for pink/magenta pixels (see snippet below); none above noise.
- [ ] New text uses the brand font roles; addresses use JetBrains Mono.
- [ ] Any new mark is the Newroz flame, not a map/rosette.
Raster pink scan (run from repo root):
```python
# python3 with Pillow
from PIL import Image; import glob
def pink(r,g,b): return r>150 and g<110 and b>120 and (r-g)>70
for f in glob.glob('**/res/drawable*/*.png',recursive=True)+glob.glob('**/res/drawable*/*.webp',recursive=True):
if '/build/' in f: continue
im=Image.open(f).convert('RGBA'); im.thumbnail((96,96)); px=im.load(); w,h=im.size; c=t=0
for y in range(h):
for x in range(w):
r,g,b,a=px[x,y]
if a<30: continue
t+=1; c+=pink(r,g,b)
if t and c/t>0.02: print(round(c/t*100,1),'%',f)
```
> Exception: third-party trademark logos (e.g. `ic_powered_by_oak`, OAK Network)
> must **not** be recolored — leave them as the owner ships them.
## Licensing note (important)
This app is a fork of **Nova Wallet**, licensed under **Apache-2.0**. Apache-2.0
lets us fork, rebrand and ship — **but you must KEEP `LICENSE` and `NOTICE`** and
their attributions, and state changes. Do **not** delete the attribution (that
would breach the license). Removing Nova's *trademark* (name/logo) from the UI is
required; preserving the *copyright notice* is also required. The package name
`io.novafoundation.nova.app` stays (Play Store identity; not a trademark issue).