Skip to content

Latest commit

ย 

History

30 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŸฆ BaseBlobs

A cozy collectible idle game built on Base โ€” raise, evolve & explore with your Blobs.

Base React TypeScript Vite AI Built

โ–ถ Play Now ยท Base.build


๐ŸŒŒ Lore

Inside the Base network, fragments of digital energy slowly began forming living creatures called BaseBlobs.

These small beings absorb energy from transactions, blocks, and network activity.

Some are sleepy. Some are chaotic. Some resonate with rare cosmic signals.

Nobody fully understands where they came from. But explorers discovered one thing:

The deeper a Blob travels into the networkโ€ฆ the stranger it becomes.


๐ŸŽฏ Core Gameplay Loop

Expeditions โ†’ Cubes โ†’ Upgrades โ†’ Blob Collection โ†’ Network Nodes โ†’ Reactor

Players:

  • send Blobs on expeditions across 6 unique zones
  • collect ๐Ÿ’  Cubes and XP
  • level up Blobs and upgrade them along the branches each one rolled at summon
  • capture and defend Network Nodes for passive income
  • summon new Blobs and expand their collection โ€” with Cubes, or instantly for 0.20 USDC
  • contribute Cubes to community Reactor events to earn real USDC on Base
  • battle other players' squads in the weekly Arena for Cube and cosmetic rewards

๐Ÿ‘พ Personality System

Each Blob has a unique personality that shapes its stats and playstyle:

Personality Bonus
๐Ÿ˜Š Happy +20% XP from all expeditions
๐Ÿ˜ด Sleepy Energy regenerates 30% faster ยท naturally high Power (best for holding Nodes)
๐Ÿ€ Lucky +15% cube reward on all zones, plus the highest Luck stat (crit-chance for double rewards)
โšก Chaotic Chance for a +50% cube reward spike on any expedition
๐ŸŒŒ Cosmic +25% all rewards at Lv.10+

โšก Energy System

Energy powers expeditions and regenerates over time.

Stat Value
Regeneration 1 per 5 minutes (30% faster with a Sleepy Blob in your collection)

๐Ÿ—บ Expedition Zones

Six zones unlock progressively as your Blob grows stronger:

Tier Zone Energy Cubes XP Unlock
I ๐ŸŸฆ ๐ŸŒฑ Base Fields 10 20โ€“50 12 Lv. 1
II ๐ŸŸฃ ๐Ÿ’  Cube Cave 15 60โ€“110 25 Lv. 4
III ๐ŸŸฃ ๐ŸŒฒ Signal Forest 20 100โ€“170 42 Lv. 7
IV ๐Ÿ”ด ๐ŸŒ‹ Neon Volcano 25 170โ€“280 65 Lv. 11
V ๐ŸŸ  ๐ŸŒŒ Void Network 30 270โ€“430 95 Lv. 15
VI ๐ŸŸก โ›“๏ธ Base Chain Core 35 400โ€“700 140 Lv. 19

Random events can fire on Expedition completion (bonus multipliers, rare drops, and more).


โฌ†๏ธ Upgrade System

Every Blob is born with its own random set of 3 branches out of 7. The set is rolled server-side at summon and can never be rerolled โ€” two Blobs of the same personality can play completely differently. Each branch has 5 levels.

Every Blob is guaranteed at least one Mining and one Combat branch, so no Blob is ever useless in either mode.

โ›๏ธ Mining branches

Branch Effect Max Bonus
โšก Speed Reduces expedition time โˆ’45%
โ›๏ธ Extraction More cubes per expedition +75%
๐Ÿ€ Fortune Increases crit chance for double cube rewards +30%
๐Ÿ“š Insight More XP per expedition +65%

โš”๏ธ Combat branches

Combat branches drive POWER โ€” used for Network Node capture, and for the upcoming Arena.

Branch Effect Max Bonus
๐Ÿ’ข Vigor Raw POWER multiplier (attack and defense) +52%
๐Ÿ›ก๏ธ Guard Strengthens defense of nodes this Blob holds +70%
๐Ÿ”ฅ Ferocity Stronger when attacking someone else's node +70%

Upgrade slot progression โ€” how many branches you can develop at once:

  • Lv. 1 โ†’ 1 branch
  • Lv. 5 โ†’ 2 branches
  • Lv. 10 โ†’ all 3 branches

๐ŸŽฒ Expedition Events

Every completed expedition rolls one event on settlement:

Event Chance Effect
โœ… Safe Return 40% Standard payout
๐Ÿ’Ž Rich Vein 25% ร—1.5 Cubes
๐ŸŒฉ๏ธ Data Storm 12% ร—0.85 Cubes, ร—1.3 XP โ€” a trade, not a loss
๐ŸŽ Blob Charm 11% Next expedition pays double Cubes
๐Ÿ”ฎ Awakening 8% Double XP
๐Ÿ‘‘ Jackpot 4% ร—3 Cubes, ร—1.5 XP

๐Ÿ“ˆ Progression & Evolution

Max Level

20

Evolution Stages

Level Form What Changes
Lv. 1โ€“4 ๐ŸŸฆ Base Blob Standard form
Lv. 5 โœจ Glow Form Neon aura ring, 2nd upgrade branch unlocked
Lv. 10 ๐Ÿ’Ž Crystal Form Orbiting particles, all upgrades unlocked
Lv. 20 ๐Ÿ‘‘ Ascended Form Golden glow, max evolution stage

๐Ÿฃ Blob Collection

Summoning

Two ways to summon, sharing the same collection cap:

  • Cubes: starts at 1,500 ๐Ÿ’  Cubes, increasing by +500 for each Blob you already own
  • USDC: flat 0.20 USDC per Blob, paid on-chain to the treasury wallet and verified server-side before the Blob is granted
  • Collection cap: 10 Blobs total, from either path combined
  • Each summon rolls a random personality Blob, starting at Lv. 1

Blob Info & FAQ

An in-app FAQ panel explains stats, personalities, upgrades, expeditions, Nodes, and the Reactor โ€” everything a new player needs to get oriented.


๐Ÿ—บ๏ธ Network Nodes

Map-based locations that generate passive Cubes once captured (accumulates up to 24h of income โ€” collect regularly).

  • Attacking: your Blob's Power (raised by Vigor, then by Ferocity when attacking) is checked against the node's defense โ€” a clear advantage guarantees capture, a close match is a coin flip.
  • Defending: a node is held by the Power of the Blob that captured it, multiplied by that Blob's Guard branch (up to +70%).
  • Fortification: the longer you hold a node, the more fortified it becomes (up to +50% extra defense after several days of continuous ownership).
  • Cooldown: a short cooldown after each attack attempt prevents back-to-back spam attacks on the same node.

โ˜ข๏ธ The Reactor

A recurring, community-wide event: contribute Cubes toward a shared pool target. When the target is reached, contributors split a real USDC pool proportional to their contribution, via a Merkle-drop claim on Base (small gas fee applies for the claim transaction). Claiming has no deadline โ€” each closed season's Merkle tree is archived, so a reward stays claimable long after a new season starts.


๐Ÿ“ฑ App Structure

Screen Content
๐Ÿ  Home Your main Blob, XP bar, energy, My Blobs collection
๐Ÿ—บ Explore Expedition zones with tier badges, timers, rewards
โฌ†๏ธ Upgrades The 3 branches this Blob rolled + evolution status
๐Ÿ›’ Shop Blob summon (Cubes or USDC)
โš”๏ธ Arena Weekly 3v3 PvP ladder, MMR matchmaking, battle replay
โ˜ข๏ธ Reactor Community USDC pool, contribute Cubes, claim your share
โ“ FAQ In-app guide to every game mechanic

๐ŸŽจ Visual Direction

Style:

  • dark neon background
  • soft blue, purple and neon glows per personality
  • rounded glassmorphism UI panels
  • cute square Blobs with expressive animated faces
  • minimal cyber aesthetic
  • cozy sci-fi vibe

Blob design:

  • rounded square body with glossy material
  • big expressive eyes, pink blush, soft smile
  • unique glow colour per personality
  • bouncy floating animations

๐Ÿ”— On-chain / Off-chain

Feature Where
Levels, XP, Cubes, upgrades, Node ownership, Arena matches Server-authoritative (Firestore + backend API)
USDC claim from Reactor events โœ… Live on Base โ€” Merkle-drop claim, BlobReactorV2 contract
Paid Blob summon โœ… Live on Base โ€” plain USDC transfer, verified server-side (no custom contract)

Wallet support: Any wallet supported via WalletConnect (Reown) โ€” including Coinbase / Base App and MetaMask.

Wallet discipline: the app never opens your wallet on its own. Signature requests happen only in response to a deliberate action โ€” background syncs, tab focus and polling all run read-only and stay silent when a session has expired.


๐Ÿ†• Latest Updates

  • Reactor rebuilt on USDC โ€” moved off the old $BLOBS token onto a new BlobReactorV2 contract paying out real USDC, via server-verified Merkle-drop claims. Past seasons are archived so a claim never expires, even after the next season starts.
  • Arena shipped โ€” weekly 3v3 PvP: register a squad, 5 fights/day, server-computed combat, MMR matchmaking against other live squads (bot opponents when the pool is empty), canvas battle replay. Season leaderboard payouts are still in progress.
  • Paid Blob summon โ€” summon instantly for 0.20 USDC as an alternative to grinding Cubes, sharing the same 10-Blob cap. Verified server-side against the actual on-chain payment, no custom contract involved.
  • Per-Blob upgrade branches โ€” 7 branches total, each Blob rolls its own 3 at summon. Mining vs Combat split, guaranteed one of each. Existing Blobs keep their original three, so nothing invested is lost.
  • Combat branches โ€” Vigor, Guard and Ferocity feed real Node and Arena combat maths (attack, defense, fortification).
  • Data Storm rebalanced โ€” was a flat โˆ’30% Cube punishment, now a trade: ร—0.85 Cubes for ร—1.3 XP. Jackpot, Awakening and Blob Charm all got slightly more common.
  • Reactor is a full screen โ€” no longer a blocking modal; navigate freely from the bottom bar like every other section.
  • Reworked Home โ€” accurate Blob stat card (the old one advertised bonuses that did not exist), per-Blob XP bars on every card, and calmer primary actions.

๐Ÿค– Built with AI

BaseBlobs was designed and built collaboratively with AI โ€” game design, balance, backend security, and UI were all shaped through conversations with Claude (Anthropic) and Gemini (Google AI Studio).


Built with โค๏ธ on Base ยท 2026

About

BaseBlobs is a cozy mobile-first collectible web app inspired by Tamagotchi, idle games, and Web3 culture.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages