Skip to content

elitekbtu/solana-hackathon

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

23 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Butaq NFT Studio ๐ŸŽฎโšก

Transform your gaming achievements into valuable digital assets on the Solana blockchain

๐Ÿš€ Live Demo

Frontend deployed at: https://solana-hackathon-5nls.vercel.app/

๐ŸŽฏ Project Overview

Butaq NFT Studio is a revolutionary platform that bridges the gap between gaming and blockchain technology. We enable gamers to mint their gaming achievements, memorable moments, and digital assets as NFTs on the Solana blockchain, creating a new economy around gaming culture.

๐ŸŒŸ Why We Built This

  • Problem: Gamers invest countless hours building achievements and memories, but these digital assets remain trapped within specific games and platforms
  • Solution: Our platform allows gamers to immortalize their achievements on the blockchain, creating lasting value and ownership
  • Vision: Build the future of gaming NFTs, one block at a time

๐Ÿ—๏ธ Architecture & Technology Stack

Frontend (/frontend)

Tech Stack: React + TypeScript + Vite + Tailwind CSS + shadcn/ui + Framer Motion

frontend/
โ”œโ”€โ”€ src/
โ”‚   โ”œโ”€โ”€ components/
โ”‚   โ”‚   โ”œโ”€โ”€ ui/           # Reusable UI components (shadcn/ui)
โ”‚   โ”‚   โ””โ”€โ”€ demos/        # Component demonstrations
โ”‚   โ”œโ”€โ”€ pages/
โ”‚   โ”‚   โ”œโ”€โ”€ Home.tsx      # Landing page
โ”‚   โ”‚   โ”œโ”€โ”€ Create.tsx    # NFT creation interface
โ”‚   โ”‚   โ”œโ”€โ”€ About.tsx     # Team information
โ”‚   โ”‚   โ””โ”€โ”€ Gallery.tsx   # NFT gallery
โ”‚   โ””โ”€โ”€ lib/              # Utilities and helpers
โ”œโ”€โ”€ public/               # Static assets & team photos
โ””โ”€โ”€ Docker configuration

Key Features:

  • ๐ŸŽจ Modern Apple-inspired design system
  • ๐ŸŒˆ Advanced animations with Framer Motion
  • ๐Ÿ“ฑ Fully responsive interface
  • โšก Fast loading with Vite
  • ๐ŸŽฏ Type-safe development with TypeScript

Backend (/backend)

Tech Stack: Node.js + Express + Solana Web3.js

backend/
โ”œโ”€โ”€ app.js              # Main Express server
โ”œโ”€โ”€ nftService.js       # NFT minting logic
โ”œโ”€โ”€ get-test-sol.js     # SOL token management
โ”œโ”€โ”€ quick-sol.js        # Quick Solana operations
โ”œโ”€โ”€ test-nft.js         # NFT testing utilities
โ””โ”€โ”€ wallet.json         # Solana wallet configuration

API Endpoints:

  • POST /api/mint-nft - Mint new gaming NFT
  • GET /api/wallet/balance - Check wallet balance
  • POST /api/upload - Upload gaming assets

Solana Integration (/anchor & /solana)

Blockchain Infrastructure:

anchor/                 # Anchor framework for Solana programs
โ”œโ”€โ”€ programs/anchor/    # Smart contract code
โ”‚   โ””โ”€โ”€ src/lib.rs     # Main program logic
โ”œโ”€โ”€ tests/             # Program tests
โ””โ”€โ”€ migrations/        # Deployment scripts

solana/
โ””โ”€โ”€ config/
    โ””โ”€โ”€ id.json        # Solana program ID

Smart Contract Features:

  • ๐ŸŽฎ Gaming NFT metadata standards
  • ๐Ÿ”’ Secure minting process
  • ๐Ÿ’ฐ Royalty management for creators
  • ๐Ÿ† Achievement verification system

๐Ÿณ Docker Configuration

Fully containerized architecture with Docker Compose:

services:
  frontend:     # React + Nginx production build
  backend:      # Node.js API server
  anchor:       # Solana development environment

Deployment:

# Build and run all services
docker-compose up --build

# Run specific service
docker-compose up frontend -d

๐Ÿ‘ฅ Team - Butaq Development Studio

Role Name Expertise
๐ŸŽฏ Product Manager Alibek Anuarbek Strategy & Vision
๐Ÿ’ป Frontend Developer Ualikhanuly Beknur React & UI/UX
โš™๏ธ Backend Developer Yermakhan Sultan Node.js & APIs
๐Ÿš€ Full-Stack Developer Satbaldiyev Turarbek End-to-end Development

๐Ÿ› ๏ธ Development Setup

Prerequisites

  • Node.js 20+
  • Docker & Docker Compose
  • Solana CLI
  • Anchor Framework

Local Development

  1. Clone the repository
git clone <repository-url>
cd solana-hackathon
  1. Frontend Development
cd frontend
npm install
npm run dev
  1. Backend Development
cd backend
npm install
node app.js
  1. Solana Program Development
cd anchor
anchor build
anchor test
anchor deploy
  1. Docker Development
# Run entire stack
docker-compose up --build

# Run specific services
docker-compose up frontend backend -d

๐ŸŽฎ Features

For Gamers

  • ๐ŸŽฏ Easy NFT Creation: Upload gaming screenshots and achievements
  • ๐Ÿ† Achievement Minting: Convert gaming milestones into NFTs
  • ๐ŸŽจ Custom Metadata: Add descriptions and attributes to NFTs
  • ๐Ÿ–ผ๏ธ Personal Gallery: Showcase your gaming NFT collection

For Developers

  • ๐Ÿ”ง Modern Tech Stack: Built with latest technologies
  • ๐Ÿ“ฆ Component Library: Reusable UI components
  • ๐ŸŽจ Design System: Consistent styling with Tailwind CSS
  • ๐Ÿงช Testing Suite: Comprehensive testing for smart contracts

For Collectors

  • ๐ŸŒŸ Unique Gaming Assets: Collect rare gaming moments
  • ๐Ÿ’Ž Verified Authenticity: Blockchain-verified ownership
  • ๐Ÿ“ˆ Value Appreciation: Investment potential in gaming culture
  • ๐Ÿ”„ Easy Trading: Simple marketplace integration

๐Ÿšฆ Project Status

  • โœ… Frontend: Deployed and fully functional
  • โœ… Backend: Core APIs implemented
  • โœ… Smart Contracts: Basic NFT minting ready
  • ๐Ÿ”„ Advanced Features: In development
  • ๐Ÿ“ฑ Mobile App: Planned for future releases

๐ŸŽจ Design Philosophy

Apple-Inspired Minimalism:

  • Clean, intuitive interfaces
  • Smooth animations and transitions
  • Focus on user experience
  • Consistent design language
  • Dark/light mode support

๐Ÿ”— Links & Resources

๐Ÿ† Hackathon Goals

  1. Innovation: Revolutionize gaming asset ownership
  2. Technology: Showcase Solana's capabilities
  3. Community: Build a platform for gamers
  4. Future: Create sustainable gaming economy

๐Ÿ“„ License

This project is built for the Solana Hackathon and represents the future of gaming NFTs.


Built with โค๏ธ by Butaq Team | Powered by Solana โšก

Building the future of gaming NFTs, one block at a time.

About

Solana Hackathon Butaq Team

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors