- Python 51.8%
- CSS 23.3%
- Astro 8.9%
- TypeScript 8.9%
- HTML 3.7%
- Other 3.4%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
| assets/mascot | ||
| docs | ||
| pet | ||
| scripts | ||
| website | ||
| .gitignore | ||
| CHANGELOG.md | ||
| README.md | ||
Nery Mizuki
© 2026 Yuri Cunha. All rights reserved. Proprietary mascot asset license (v1.1).
The official character home of Nery Mizuki, the mascot of Mnerys ("Built to be yours") and of Yuri Cunha's web properties.
This repository is the canonical source of truth for the character: the approved artwork kit, the identity and usage rules, and the license. Projects that feature Nery copy the assets from a tagged release of this repository and record the kit version they use. She is deliberately not packaged (no npm or similar): every project integrates and adapts her artwork for its own surface, and this repository exists so those adaptations never drift from the approved look.
Nery is the mascot, never the logo: the Mnerys geometric M stays the logo across UI, favicon, PWA and wordmark.
The character
- Name: Nery Mizuki
- Style: friendly 2D anime chibi
- Look: copper-red hair, amber eyes, cream hair bows, charcoal hoodie with warm orange details
- Palette: dark charcoal
#211915, warm surface#2A211D, terracotta accent#CC785C, soft cream#F0E9E3
Full identity, personality and do/don't rules: docs/IDENTITY.md.
Repository layout
assets/mascot/
├── LICENSE.md Proprietary mascot asset license (v1.1)
├── mascot.json Character metadata and license reference
├── nery-mizuki-avatar.webp Current UI avatar (kept for compatibility)
└── kit-v1/
├── manifest.json Kit inventory: dimensions, provenance, limits
├── source/ Approved 1536x1024 character sheet + 8 original crops
├── transparent/ 8 poses with real alpha, PNG + WebP
├── avatars/ 128/256/512 px avatars, PNG + WebP
└── preview/ Kit preview composition
docs/
├── IDENTITY.md Who Nery is and how to use her
└── ARTWORK-STATUS.md Provenance, native sizes and known limitations
CHANGELOG.md Kit and license history
Kit v1 contents
The approved character sheet (1536x1024) carries eight poses, exported with real alpha in PNG and WebP:
| Context | Asset (relative to assets/mascot/kit-v1/) |
|---|---|
| Welcome / success | transparent/nery-happy.webp |
| Thinking / waiting | transparent/nery-thinking.webp |
| Working / tools | transparent/nery-coding.webp |
| Break / onboarding | transparent/nery-coffee.webp |
| Rest / idle | transparent/nery-sleeping.webp |
| Friendly integrations | transparent/nery-with-cat.webp |
| Character presentation | transparent/nery-fullbody.png |
| Alternative avatar | avatars/nery-avatar-256.webp |
Using Nery in a project
- Download the kit from the latest tagged release of this repository (or the matching
kit-vXfolder on the main branch). - Copy the assets your surface needs and record the kit version in your project (for example
Nery kit v1.0). - Adapt presentation (placement, sizes, motion) freely; never redraw the character or invent features she does not have. New poses and expressions are produced and approved through this repository.
- Respect the identity rules (docs/IDENTITY.md) and the license (assets/mascot/LICENSE.md).
Known artwork limitations (native sizes, alpha edges) are documented in docs/ARTWORK-STATUS.md. In short: poses keep their original resolution (the full-body pose is 195x403 px), transparency was machine-extracted and hand-cleaned, and nothing here is an upscaled painting.
Where she appears
- Mnerys (production): welcome, onboarding, empty states and interface accents.
- Yuri Cunha's web properties (yuricunha.com and its subdomains): authorized in the license v1.1 for the rights holder's own properties.
Animated Petdex pack
The Petdex v2 pet is in pet/nery/, with nine animation
states (6/8/8/4/5/8/6/6/6 native frames) and a companion pet.json.
The web preview uses the full motion v5 atlas: 12 frames for
each non-walking action and 32 per walking direction, with shared timing
in motion.json and no opacity blending between poses. A standalone
walking atlases are available as walk-32.webp and the compatibility
sample walk-16.webp. The walking artwork follows the existing Idle style
and rounded chibi proportions; the other seven action drawings are unchanged.
The native Petdex renderer uses its fixed eight walking frames. The
optional 16 cursor-look cells (rows 9–10) are not yet illustrated.
Rebuild and check both animations:
python3 scripts/build_petpack.py
python3 scripts/validate_petpack.py
python3 scripts/validate_walk_animation.py
python3 scripts/validate_motion.py
python3 scripts/test_petpack_regressions.py
python3 scripts/test_motion_alignment.py
python3 scripts/test_walk_motion.py
python3 scripts/test_walk_scope.py
python3 scripts/render_pet_previews.py
See full frame audit, sources and visual limitations,
the all-state web preview, and the
standalone interactive review, with slow
playback and frame stepping. Install the Python dependencies from
scripts/requirements.txt before building.
The walking review plays actual GIFs beside the unchanged Idle, Waving and Waiting references, including both walking directions and the prior cycle. The website preview has its own timing and state transitions; these browser-only enhancements are not transferred into third-party Petdex clients.
License
The Nery Mizuki character and artwork are proprietary: Copyright (c) 2026 Yuri Cunha, all rights reserved, under the Nery Mizuki Proprietary Mascot Asset License. The license permits installation and display within an authorized Mnerys instance, and (since v1.1) use within Yuri Cunha's own properties as distributed by the rights holder through this official repository. Redistribution, independent reuse, packaging and derivative artwork require the rights holder's express written permission. This is not an open-source image license, and it is separate from the AGPL-3.0 license of the Mnerys code.
Mirrors
- GitHub (primary): https://github.com/isyuricunha/nery
- GitLab: https://gitlab.com/isyuricunha/nery
- YuGit: https://git.yuricunha.com/isyuricunha/nery