🦕 Dinoverse

Explore the prehistoric world through interactive education and digital collection

🎯 Overview

Dinoverse is an educational platform that combines engaging dinosaur knowledge with gamification. The project consists of a web application for exploration and an Android mobile app that allows users to collect dinosaurs by scanning QR codes, creating a bridge between physical merchandise and digital experience.

The platform features:

• 🌐 Web Application: Rich, visually engaging dinosaur encyclopedia
• 📱 Android App: Personal dinosaur collection with QR scanning and AI recognition
• 🤖 AI Integration: On-device YOLOv8 model for dinosaur image recognition
• 🎮 Gamification: Level system, favorites, and collection management

🎬 Demo Video

Watch our introduction video to see Dinoverse in action:

Click the image above to watch the full demo on YouTube

📚 Documentation

• Web Application: Interactive dinosaur encyclopedia with detailed information
• Android App Report: View Full Documentation
• Database Schema: SQLite with Room ORM (4 tables: user, category, dino, user_dino)
• Setup Guide: SUPPORT.md - Detailed installation and troubleshooting

📂 Project Structure

📁 Dinoverse
│
├── 📁 main/                        # Main applications
│   │
│   ├── 📁 app/                     # Android Studio Application (Java)
│   │   └── 📁 app/
│   │       └── 📁 src/
│   │           └── 📁 main/
│   │               ├── 📁 assets/          # Database, AI model, resources
│   │               ├── 📁 java/com/Aohkne/dinoverse/
│   │               │   ├── 📁 adapter/             # RecyclerView adapters
│   │               │   ├── 📁 data/                # Data layer
│   │               │   │   ├── 📁 dao/             # Database access objects
│   │               │   │   ├── 📁 model/           # Data models
│   │               │   │   ├── 📁 repository/      # Repository patter
│   │               │   │   └── ☕ AppDatabase.java # Room database instance
│   │               │   │
│   │               │   ├── 📁 ui/                  # User interface
│   │               │   │   ├── 📁 auth/            # Authentication screens
│   │               │   ├── 📁 utils/               # Utility classes
│   │               │   ├── ☕ LauncherActivity.java # Splash screen
│   │               │   └── ☕ MainActivity.java     # Main container
│   │               │
│   │               ├── 📁 res/                     # Android resources
│   │               │   ├── 📁 drawable/            # Images, icons, backgrounds
│   │               │   ├── 📁 layout/              # XML layouts
│   │               │   ├── 📁 values/              # Colors, strings, themes
│   │               │   ├── 📁 font/                # Custom fonts
│   │               │   └── 📁 menu/                # Bottom navigation menu
│   │               │
│   │               └── ⚙️ AndroidManifest.xml     # App configuration
│   │
│   └── 📁 web/                     # Web Application (React + Vite)
│       ├── 📁 node_modules/        # Installed packages
│       ├── 📁 public/              # Static files
│       │
│       ├── 📁 src/                 # Source code
│       │   ├── 📁 assets/          # Images, fonts, static files
│       │   ├── 📁 components/      # Reusable UI components
│       │   ├── 📁 pages/           # Web pages
│       │   ├── 📁 hooks/           # Custom React hooks
│       │   ├── 📁 services/        # API calls and services
│       │   ├── 📁 styles/          # CSS and SCSS files
│       │   └── 📁 utils/           # Utility functions
│       │
│       ├── 📄 .gitignore           # Git ignore rules
│       ├── 📄 index.html           # Main HTML template
│       ├── 📄 package.json         # Dependencies and scripts
│       ├── 📄 package-lock.json    # Locked dependency versions
│       └── 📄 vite.config.js       # Vite configuration
│
└── 📁 tools/                       # QR Code Generation Tools
    ├── 📁 output_qrcodes/          # Generated QR codes output
    ├── 🐍 generate_qrcodes.py      # QR code generator script
    └── 📄 requirements.txt         # Python dependencies

✨ Features

🌐 Web Application

• 📚 Dinosaur Encyclopedia: Comprehensive dinosaur information with rich visuals
• 🎨 Modern UI/UX: Built with React and Vite for optimal performance
• 🔍 Search & Filter: Easy navigation through dinosaur species
• 📱 Responsive Design: Works seamlessly across all devices

📱 Android Mobile App

• 🎮 Digital Collection: Personal dinosaur collection management
• 📷 QR Code Scanner: Scan codes to unlock and collect new dinosaurs
• 🤖 DinoBuddy AI: On-device image recognition using YOLOv8 TFLite model
• ⭐ Favorites System: Mark and organize favorite dinosaurs
• 👤 User Profile: Track level, collection count, and progress
• 🎯 Gamification: Level up system based on collection size
• 🔒 Secure Authentication: User registration and login with password hashing
• 📊 Detailed Dinosaur Info: Period, location, behavior, fossils, and stories
• 🎨 Beautiful UI: Material Design with custom fonts and shadows
• 💾 Offline-First: All data stored locally using Room database

🛠️ Tools

• 🎫 QR Code Generator: Python script to generate unique QR codes for dinosaurs
• 📦 Batch Processing: Generate multiple QR codes at once
• 🖼️ Custom Styling: Configurable QR code appearance

🚀 Quick Start

Web Application

See SUPPORT.md for detailed setup instructions.

cd main/web
npm install
npm run dev

Android Application

1. Open the project in Android Studio
2. Let Gradle sync dependencies automatically
3. Connect an Android device or start an emulator (API 26+)
4. Click Run ▶️ button

QR Code Generator Tool

See SUPPORT.md for detailed setup instructions.

cd tools
pip install -r requirements.txt
python generate_qrcodes.py

📱 Android App Features Breakdown

Core Screens

1. 🔐 Authentication

   • Sign In / Sign Up
   • Edit Profile
   • Change Password

2. 🏠 Home (Dino Collection)

   • ViewPager2 carousel of owned dinosaurs
   • Swipe to browse collection
   • Real-time greeting with clock

3. 📖 Dino Detail

   • Comprehensive dinosaur information
   • Rename capability
   • Add/remove favorites
   • Story and facts

4. ⭐ Favorites

   • Grid layout of favorite dinosaurs
   • Quick access to loved species

5. 👤 Profile

   • User information display
   • Collection statistics
   • Owned dinosaurs horizontal scroll

6. 🤖 DinoBuddy (AI)

   • Take photo or select from gallery
   • On-device YOLOv8 inference
   • Confidence percentage display

Technical Highlights

• Architecture: Repository Pattern with Room ORM
• Database: Pre-populated SQLite (dinoverse.db)
• AI Model: YOLOv8n TFLite (fully offline)
• UI: Material Design with custom components
• Security: BCrypt password hashing
• Session Management: Persistent user login state

🗄️ Database Schema

Tables

1. user

   • id (PK), email, fullName, username, hashedPassword
   • avatar, gender, dob, level, dinoCount

2. category

   • id (PK), name, img
   • Categories: Carnivores, Herbivores, Pterosaurs, Aquatic Reptiles

3. dino

   • id (PK), qrCode (unique), imgChibi, displayName, dinoName
   • description, story, period, dinosaurType, location
   • behavior, fossil, categoryId (FK)

4. user_dino (Join table)

   • userId (PK, FK), dinoId (PK, FK), isFavorite

📞 Contact

• Email: aohkne@gmail.com
• GitHub: https://github.com/Aohkne/Dinoverse
• Project Repository: https://github.com/Aohkne/Dinoverse
• Support: See SUPPORT.md for technical assistance

📄 License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

---

🌟 Star Us on GitHub!

If you find this project interesting, please consider giving it a star ⭐ on GitHub!

---

Made with 🦕 by the Dinoverse Team