> For the complete documentation index, see [llms.txt](https://whitepaper.octopeeps.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://whitepaper.octopeeps.com/utilities/peep-reef.md).

# Peep Reef

A live undersea town that puts the whole OctoPeeps ecosystem on one map. Every building is a real feature, every resident a real Kiddo. Read only, not a game.

Over the years OctoPeeps has grown into a whole ecosystem: $FATH, the Raffle Market, Peep Duels, on-chain games, NFT wallets, Kiddo Profiles, staking and raid bosses. Peep Reef puts all of it on one living map.

It is a little town under the sea. Every building is a real OctoPeeps feature, and every resident is a real Octo Kiddo or Octo Kiddo 2.0. It is not a game: it is a window into everything we have built, and the same live town for everyone who visits.

<https://octopeeps.com/reef>

## Built in-house

Peep Reef is our own world. The OctoPeeps team built it from scratch, and it runs on our own website like every other OctoPeeps page. It is not built on a metaverse platform such as Decentraland or The Sandbox, uses no outside game engine or hosted world service, and needs no extra account. The residents come from our own contracts, every Kiddo is drawn from our own trait art, and the places are our own features. Like any website it uses free open-source building blocks for drawing in the browser, but the world itself is ours.

## The buildings

Tap a building and its roof lifts off. You see who is inside, meet the character who runs it, and get a button straight to the real feature.

| Place             | Who runs it             | Leads to                                                                                                                                              |
| ----------------- | ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| Anchor Bank       | Mr. Grouper             | $FATH and where to buy it                                                                                                                             |
| Coral Market      | Coralie the seahorse    | The Raffle Market                                                                                                                                     |
| Bubble Arena      | Sharky                  | Peep Duels                                                                                                                                            |
| Lucky Clam Arcade | Blinky the anglerfish   | On-chain games                                                                                                                                        |
| Reef Post         | Pip the postal fish     | NFT wallets for Kiddos 2.0                                                                                                                            |
| Bocto Workshop    | Bocto the bot           | [Bocto](https://whitepaper.octopeeps.com/products/products/bocto.md), our Discord bot                                                                 |
| Octopin Depot     | Pinny the porcupinefish | [Octopin](https://whitepaper.octopeeps.com/products/products/octopin.md), where the Kiddos' metadata is pinned                                        |
| Shell School      | Professor Inkwell       | Kiddo Profiles                                                                                                                                        |
| Kiddo Hatchery    | Nanny Jelly             | Octo Kiddos 2.0                                                                                                                                       |
| Clam Beds         | Old Barnacle            | Staking history (staking has ended; hard-staked Kiddos still nap here)                                                                                |
| Kelp Café         | Pinch the barista crab  | Where Kiddos hang out                                                                                                                                 |
| The Kwaken        | -                       | [Raid bosses](https://whitepaper.octopeeps.com/utilities/raid-boss.md) in our Discord, followed on [octopeeps.com/raids](https://octopeeps.com/raids) |

Puff the pufferfish is the town crier and shouts the latest OctoPeeps news, and Shelby drives the Turtle Bus. The town's characters notice what Kiddos are doing: Pinch serves whoever walks up to the café counter, Sharky calls the duels. A "Wanted: Kwaken" board by the square leads to the raids too.

## The residents

Every minted Kiddo lives in the reef, from both collections. Each one is a little 3D toy built from its own traits: its eyes, hat or hair, outfit and the item it holds, in the colours of its NFT art. The 1/1 Kiddos look like their characters too.

About 24 Kiddos are in town at any moment. Every 5 minutes the Turtle Bus brings a few in and takes a few home, and a visit lasts about 30 minutes. While they are in town they grab a kelp latte, read at the school, shop, duel, cheer at the arena, nap in the park and chat with each other.

Soft-staked Kiddos keep walking around town with a tag on their card. Kiddos 2.0 that are still hard-staked nap in giant clams in the Clam Beds, eight at a time, taking turns every hour.

## Find your Kiddo

Tap **Where is my peep?** and type a token ID, or connect your wallet to see all your Kiddos at once. Connecting is read only: nothing is signed and nothing is sent.

* If your Kiddo is in town, the camera follows it around.
* If it is out of town, you see when its next visit is.
* If it is in your wallet, you can **call it in** right away. It arrives by bus and stays for 30 minutes. Only you see Kiddos you call in, up to 3 at a time.

## How it works

* **Same town for everyone.** The town runs on the clock. Who is in town and what they do is worked out the same way on every device, so you and a friend see the same Kiddos in the same places at the same moment. There is no server behind it.
* **Straight from the blockchain.** The population count and your wallet's Kiddos are read live from Polygon. The list of residents is a snapshot of every minted Kiddo, refreshed when we update the site, so freshly minted Kiddos move in with the next update.
* **Day and night.** The site's light and dark themes are day and night under the sea.
* **Sound.** Turn the sound on for music made live in your browser, brighter by day and dreamier at night, and the sounds of the town as you get close: cups in the café, the arcade, the arena crowd, the bus horn, the fountain and the Kwaken.
* **On phones.** The town runs in a lighter mode on phones, with the same town and the same Kiddos.

## It's a preview

Peep Reef is new and we want to hear from you. Tell us in Discord what should be in town next, which feature deserves a building, or if something looks off, like a Kiddo wearing the wrong hat.
