ROKI NFT Generator (Internal Tool)

NEW IN v3 — an internal web-based NFT art generator and creative-review tool. Built first for the 3,333 ROKI mint, designed to become a sellable product later (NFT launchpad infrastructure).

#18.5.1 Purpose

The NFT Generator is the practical tool that produces the 3,333 ROKI collection. It is Phase 1 of the launchpad infrastructure — a working generator UI with creator-review features that go beyond what competitors like LaunchMyNFT currently offer. Post-mint, the same tool is repackaged as a SaaS launchpad component, with the generator as the core differentiator.

#18.5.2 Stack

API

• Node + TypeScript + Express
• node:sqlite for local persistence
• sharp for image composition

Web

• React + TypeScript
• Tailwind
• Vite

Repo

• Monorepo via npm workspaces

#18.5.3 Core Features (Shipped)

• Seven layer categories — Background, Body, Face, Head, Clothes, Effects, Hand
• Layer incompatibility matrix — prevents invalid combinations at generation time
• Z-order management with per-combo overrides (for edge cases where default layer order breaks)
• Count-as-source-of-truth rarity — the counts of each trait are the canonical number; percentages are derived for display
• Two-variant output per NFT — a full composite image AND a transparent-background version for in-game use. Pixel parity is guaranteed by construction, not by post-hoc alignment
• Browse grid — paginated, 50 per page, 5×10 layout for reviewing the full collection
• Per-NFT regen with deterministic sub-seeding — regenerate one specific NFT without disturbing any others
• Lock-and-reroll — lock specific traits, reroll the rest. The creator can say ‘keep this hat and these eyes, re-roll everything else.’
• Live rarity ledger drawer — a drawer view that shows the current rarity distribution across the whole collection, highlighting any traits that are over- or under-represented vs their target rarity
• Staging/commit model — regens land in a staged state and require an explicit commit step before they become part of the collection. Prevents accidental commits of test rolls
• Manual character creation — hand-pick every trait for a specific NFT. Save-as-draft, seed-from-existing-NFT (clone any existing ID as a starting point), and explicit assignment to a specific token ID
• Final export pipeline — produces an Arweave-ready folder using the Metaplex Core metadata schema. Rarity counts in the export reflect the real post-manual-edit state of the collection, not pre-edit projections
• AI lore CLI prototype — Anthropic Haiku generates 2-3 sentence fight-night style bios per NFT, seeded from the NFT's trait set
• Metadata validator (npm run validate) — catches schema violations before Arweave upload

#18.5.4 Output Structure

• export/images/full/<id>.png — full composite image
• export/images/transparent/<id>.png — transparent background for in-game use
• export/metadata/<id>.json — per-NFT Metaplex Core metadata
• export/collection.json — collection-level metadata
• export/rarity-final.json — true final rarity counts after all manual edits
• export/manifest.json — upload manifest for Arweave pipeline

#18.5.5 Future Product Path

Repackage the Generator as a SaaS launchpad after ROKI's own mint validates it. Positioning vs. LaunchMyNFT: the generator UI is the core differentiator — live rarity management, lock-and-reroll, staging, and hybrid visible/invisible trait support are real advantages competitors don't address well. Halal-conscious framing and the game-coupling story give the platform a distinct pitch for any partner project that wants in.