# PokéDeck

**The PokéDeck** is a multifunctional **pocket companion** (like a Tamagotchi) packed with cool features for developers and tech lovers. Inspired by the GitHub Badger and styled like a Pokédex, its both **useful** and **fun**!

![](https://hc-cdn.hel1.your-objectstorage.com/s/v3/bd15a1007fcbb0a5cf2deca561a3b4e89ce385e4_pokedeck_drawing_v1.png)

_I can't demo the PCB right now as I haven't gotten it yet so will be demoing the firmware instead! And yes the firmware will run without error on the PCB :). I have tested it on the Sprig with the Orpheus Pico!!_

**3d Model**:
![3d Model](https://files.slack.com/files-pri/T0266FRGM-F08PNK1688Y/image.png?pub_secret=d17f95e6ff)

**Schematic**:
![Schematic](https://hc-cdn.hel1.your-objectstorage.com/s/v3/101db1a496de3fed5413ddaba80aae821ac42628_schematic_pokedeck_2025-04-28.png)

It can be used to display your GitHub profile, play games, run timers, check sensor data, and carry a virtual pet! Powered by an **Orpheus Pico** (a custom **Raspberry Pi Pico**), the PokéDeck is open-source, rechargeable, and modular (kind of). It can be clipped to your bag, worn as a badge, or kept in your pocket!

---

## ⚙️ Core Features

- **Hackable Hardware:** Built on the **Raspberry Pi Pico**, fully programmable with CircuitPython.
- **Rechargeable Battery:** 400mAh LiPo battery ~~with low power consumption via **E-Ink display**~~.
- **GitHub + Portfolio Display:** Showcase your name, role, GitHub profile, and scan a QR code to share your work instantly.
- **Pomodoro Timer:** Stay productive with visual + haptic feedback.
- **Mini Games:** Includes classics like Breakout.
- **Built-in Sensors:** Track temperature, humidity, and movement with onboard sensors.
- **Visual Alerts:** LEDs for alerts and event notifications.
- **Vibration Motor:** Tactile feedback for timers, games, and interactions.
- **Modular Expansion Header:** Ready for add-ons like GPS, NFC, or sound modules.

---

# Hackamon: The OS Inside

![Hackamon Logo](https://cloud-7adfvs3rn-hack-club-bot.vercel.app/0hackamon__1_.png)

**Hackamon** is a custom **virtual pet + OS** designed specifically for ~~a custom Tamagotchi~~ the PokéDeck (and tested on **Sprig** with an **Orpheus Pico**).  
Charge your Hackamon, play games, check your timers, and more — all with retro pixel-art charm (drawn by me!!).  
It's the heart of the PokéDeck.

🎥 **Demo (running on Sprig):** _(Click to play video)_

[![Hackamon OS Demo](https://hc-cdn.hel1.your-objectstorage.com/s/v3/7f209d53b91d2cdff0e3565f87ccc52355f96b45_image.png)](https://sleeping.wtf/f-8B3hfi05_FPOMVXcGH-.mp4)

<!-- [![Hackamon OS Demo](https://hc-cdn.hel1.your-objectstorage.com/s/v3/7f209d53b91d2cdff0e3565f87ccc52355f96b45_image.png)](https://hc-cdn.hel1.your-objectstorage.com/s/v3/030cac5edc138051b9962804ac5a3dd1815fb0c6_hackamon_orpheus_pico_sprig.mp4)
-->

_Flip a Coin_

![Flip a Coin](https://cloud-1erh0yg7y-hack-club-bot.vercel.app/0screenrecording2025-01-24at1.16.42am-ezgif.com-video-to-gif-converter.gif)

_Roll a Dice_

![Roll a Dice](https://cloud-55rzzph2x-hack-club-bot.vercel.app/1dice-roll_hackamon.gif)

_Stopwatch_

![Stopwatch](https://cloud-55rzzph2x-hack-club-bot.vercel.app/0stopwatch_hackamon.gif)

_Breakout Minigame_

![Breaout Scene](https://cloud-d838srl6u-hack-club-bot.vercel.app/3hackamon_demo_breakout.gif)

_Charging Station_

![Charging Scene](https://cloud-d838srl6u-hack-club-bot.vercel.app/2hackamon_demo_charging_station.gif)

_Leaderboard_

![Leaderboard](https://cloud-d838srl6u-hack-club-bot.vercel.app/1hackamon_demo_leaderboard.gif)

---

## 🎮 Hackamon Game Features

- 🎨 **All Pixel Art Hand-Drawn** by me
- 🧭 **Menu Screen:** Flip coins, roll dice, or start a stopwatch!
- 🎲 **Utility Tools:** Use your PokéDeck as a real-life coin flipper and dice roller.
- 🏡 **Home Scene:** The central hub of your Hackamon’s life.
- ⚡ **Charging Station:** Keep your pet powered up with animated charging.
- 🕹️ **Mini-Games:** Breakout for now.
- 🧠 **Smart UI:** Interactive buttons with visual feedback, pointers, and dynamic bars for:
  - Mood 😊
  - Battery 🔋
  - Time of day 🌞🌙
- 📈 **Leveling System:** Your Hackamon grows stronger every day it survives.
- 💾 **Save System:** Power off safely — your progress is saved.
- 🌐 **~~Online~~ Leaderboard:** Compete and climb the ranks!

---

## 🔮 Upcoming Features

- ⚔️ **Online Battle System**
- 🛠️ **Hackamon Upgrade System**
- 🧱 **More Mini-Games & Scenes**

---

## 🤝 Contribute

Anyone can contribute! The PokéDeck runs on **CircuitPython**.  
If you love electronics, pixel art, or game development — feel free to contribute!

🎨 [Hackamon Logo on Figma](https://www.figma.com/design/dQcPl1JKnt22KXzQSrtTxS/Hackamon?node-id=0-1&t=CXbKBUuJU05pKmqu-1)

---

**Built with ❤️ by [Irtaza](https://github.com/Irtaza2009)**

---