# burningzombies/interface architecture

> Architecture diagram of the GitHub repository burningzombies/interface, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/burningzombies/interface
- Repository: https://github.com/burningzombies/interface

## Overview

##### Main System Components

a) Frontend Layer (Next.js Application)
- Divide into major feature modules:
- NFT Marketplace
- Staking System
- Minting Interface
- User Management
- Token Management (Burning/Transfer)

b) Web3 Integration Layer
- Web3 hooks and connections
- Wallet integration
- Smart contract interactions

c) Blockchain Layer (Avalanche)
- Smart Contracts
- Token Systems
- Storage Systems

##### Component Relationships

a) User Flow Connections:
- User → Web3 Bar → Wallet Connection
- User → Marketplace → Smart Contracts
- User → Staking System → Smart Contracts

b) Data Flow Connections:
- Components → Web3 Hooks → Blockchain
- Pages → Components → Web3 Actions

##### Specific Implementation Details

Create sections for:

a) Core Features (based on components structure):
- Minting System (/components/mint/*)
- Staking System (/components/staking-*)
- Marketplace Features (/components/web3-actions/*)
- Token Management (/components/burn-token/*, /components/transfer-token/*)

b) Supporting Systems:
- Layout & Navigation
- User Interface Components
- Web3 Integration Utilities

##### Technical Stack Highlights

Technology badges for:
- Next.js
- TypeScript
- Avalanche
- Web3

##### Key Interactions to Highlight

Critical paths:
- Minting Flow
- Staking Flow
- Trading Flow
- Token Burning Flow

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Frontend
        UI[User Interface]
        NFT[NFT Marketplace]:::marketplace
        STAKE[Staking System]:::staking
        MINT[Minting Interface]:::minting
        TOKEN[Token Management]:::token
        USER[User Management]:::user
    end

    subgraph Web3Integration
        W3BAR[Web3 Bar]:::web3
        W3WRAP[Web3 Wrapper]:::web3
        HOOKS[Web3 Hooks]:::web3
    end

    subgraph BlockchainLayer
        AVAX[Avalanche Network]
        CONTRACTS[Smart Contracts]
        STORAGE[Storage Systems]
    end

    subgraph MarketFeatures
        BUY[Buy NFT]:::market
        LIST[List NFT]:::market
        CANCEL[Cancel Listing]:::market
        STATS[Market Stats]:::market
    end

    subgraph CoreComponents
        BURN[Burn Token]:::core
        TRANSFER[Transfer Token]:::core
        STAKE_CARD[Staking Card]:::core
        STAKE_INFO[Staking Info]:::core
        MINT_BTN[Mint Button]:::core
        MINT_PROG[Mint Progress]:::core
    end

    subgraph Support
        LAYOUT[Layout System]:::support
        NAV[Navigation]:::support
        UTILS[Utilities]:::support
    end

    UI --> W3BAR
    UI --> NFT
    UI --> STAKE
    UI --> MINT
    UI --> TOKEN
    UI --> USER

    NFT --> MarketFeatures
    STAKE --> STAKE_CARD
    STAKE --> STAKE_INFO
    MINT --> MINT_BTN
    MINT --> MINT_PROG
    TOKEN --> BURN
    TOKEN --> TRANSFER

    MarketFeatures --> W3WRAP
    CoreComponents --> W3WRAP
    W3WRAP --> HOOKS
    HOOKS --> CONTRACTS
    CONTRACTS --> AVAX
    CONTRACTS --> STORAGE

    %% Click Events
    click NFT "https://github.com/burningzombies/interface/tree/main/pages/marketplace"
    click STAKE "https://github.com/burningzombies/interface/tree/main/pages/stake"
    click BURN "https://github.com/burningzombies/interface/tree/main/components/burn-token"
    click TRANSFER "https://github.com/burningzombies/interface/tree/main/components/transfer-token"
    click W3BAR "https://github.com/burningzombies/interface/tree/main/components/layout/web3-bar"
    click W3WRAP "https://github.com/burningzombies/interface/tree/main/components/web3-wrapper"
    click HOOKS "https://github.com/burningzombies/interface/blob/main/hooks/use-web3.ts"
    click USER "https://github.com/burningzombies/interface/blob/main/pages/users/[address].tsx"
    click LAYOUT "https://github.com/burningzombies/interface/tree/main/components/layout"
    click NAV "https://github.com/burningzombies/interface/tree/main/components/layout/navbar"
    click BUY "https://github.com/burningzombies/interface/tree/main/components/web3-actions/buy"
    click LIST "https://github.com/burningzombies/interface/tree/main/components/web3-actions/list"
    click CANCEL "https://github.com/burningzombies/interface/tree/main/components/web3-actions/cancel-listing"
    click STATS "https://github.com/burningzombies/interface/tree/main/components/market-stats"
    click STAKE_CARD "https://github.com/burningzombies/interface/tree/main/components/staking-card"
    click STAKE_INFO "https://github.com/burningzombies/interface/tree/main/components/staking-info"
    click MINT_BTN "https://github.com/burningzombies/interface/tree/main/components/mint/button"
    click MINT_PROG "https://github.com/burningzombies/interface/tree/main/components/mint/progress"

    %% Styling
    classDef marketplace fill:#3498db
    classDef staking fill:#2ecc71
    classDef minting fill:#9b59b6
    classDef token fill:#e74c3c
    classDef user fill:#f1c40f
    classDef web3 fill:#1abc9c
    classDef market fill:#e67e22
    classDef core fill:#34495e
    classDef support fill:#95a5a6
```
