Skip to content

alexcolls/qwami

Repository files navigation

☀️ QWAMI Token - Informative Landing Page

Interactive scrolling website for the QWAMI token - the native utility token that powers KWAMI AI companions.

🎯 Overview

QWAMI is the native KWAMI ecosystem token that powers AI companions and distributes weekly dividends every Friday. Holders can recharge KWAMI capabilities, stake for rewards, and earn passive income from marketplace and minting profits.

Core Features

  • 💰 Weekly Dividends - Earn 80% of ecosystem profits every Friday
  • 🔒 Staking - Stake for APY rewards while maintaining dividend eligibility
  • Energy - Powers AI API calls (ElevenLabs, OpenAI) and DAO voting
  • 🔗 Connections - Expands app integration capacity (Instagram, WhatsApp, Gmail, etc.)
  • 🦋 Metamorphosis - Unlocks multiple KWAMI configurations (Mind, Soul, Body)

📊 Tokenomics

  • Price: 1 QWAMI = $0.01 USD
  • Max Supply: 1,000,000,000,000 (1 Trillion)
  • Decimals: 0 (Integer token)
  • Network: Solana SPL
  • Model: Deflationary (burn-based) + Revenue sharing
  • Dividends: 80% of profits distributed weekly
  • Revenue: market.kwami.io + candy.kwami.io

🏗️ Tech Stack

  • Framework: Nuxt 3 (SPA mode)
  • Styling: Custom CSS with animations
  • Network: Solana blockchain
  • Inspiration: kwami.io landing page style

🚀 Quick Start

Prerequisites

  • Node.js 18+ or Bun
  • Modern web browser

Installation

# Install dependencies
npm install  # or bun install

# Start development server
npm run dev  # or bun dev

Open http://localhost:3001

Build for Production

# Type check and build
npm run build:check  # or bun run build:check

# Build only
npm run build  # or bun build

# Preview production build
npm run preview  # or bun preview

📁 Project Structure

qwami/
├── app/                    # Application code (Nuxt 4 structure)
│   ├── app.vue            # Root application component
│   ├── pages/
│   │   └── index.vue      # Main landing page
│   └── assets/
│       ├── css/
│       │   └── main.css   # Global styles and animations
│       └── js/
│           └── main.ts    # Client-side TypeScript logic
│
├── server/                 # Server-side code (API routes)
│   └── api/               # Future API endpoints
│
├── public/                 # Static assets
│   └── favicon.svg
│
├── nuxt.config.ts         # Nuxt configuration
├── tsconfig.json          # TypeScript configuration
├── package.json           # Dependencies and scripts
│
└── docs/                  # Documentation
    ├── README.md
    ├── QWAMI_TOKEN.md     # Token specifications
    ├── DEPLOYMENT.md      # Deployment guide
    └── CHANGELOG.md       # Version history

🎨 Features

Informative Sections (16 Sections)

  1. Introduction - Overview of QWAMI token
  2. What is QWAMI - Core concept and utility
  3. Energy - AI API fuel and DAO voting power
  4. Connections - App integration expansion
  5. Metamorphosis - Multiple KWAMI configurations
  6. Tokenomics - Supply, price, deflationary model
  7. Weekly Dividends - 80% profit sharing every Friday
  8. Staking - APY rewards + dividend eligibility
  9. DAO Governance - Community participation
  10. How to Get QWAMI - Purchase methods
  11. Burning Mechanism - Token destruction mechanics
  12. KWAMI NFT Integration - NFT synergy
  13. Ecosystem Revenue - Marketplace and minting profits
  14. Security & Audits - Code quality assurance
  15. Roadmap - Future development
  16. Get Started - CTA and documentation

Visual Style

  • Animated 3D blob visualization (Three.js, inspired by kwami.io) ✅
  • Smooth scroll transitions between sections
  • Dynamic color palettes per section
  • Interactive sidebar navigation with spheres
  • Responsive design for mobile and desktop
  • Custom cursor light effect (desktop only)

Interactions

  • Click sidebar spheres to navigate sections
  • Scroll to progress through content
  • Action buttons for external links
  • Smooth transitions and animations

🎯 Use Cases

This landing page is designed to:

  • Educate users about QWAMI token utility
  • Explain Energy, Connections, and Metamorphosis features
  • Drive traffic to mint/purchase interfaces
  • Showcase tokenomics and ecosystem
  • Build community engagement

🌐 Ecosystem Integration

QWAMI is part of the broader KWAMI ecosystem:

  • kwami.io - Core AI companion framework
  • qwami.io - QWAMI utility token (this site)
  • quami.io - Services and integrations platform
  • candy.kwami.io - KWAMI NFT minting

📚 Documentation

For detailed information about:

🛠️ Development

File Descriptions

  • app/pages/index.vue - Main landing page with 16 informative sections
  • app/assets/js/main.ts - Scroll management, navigation, color transitions
  • app/assets/css/main.css - Responsive styles, animations, visual effects
  • nuxt.config.ts - Nuxt configuration (SPA mode)

Key Classes

  • ScrollManager - Handles section transitions and color updates
  • SidebarNavigator - Manages navigation spheres
  • CursorLight - Custom cursor light effect
  • ActionButtonManager - Handles CTA button interactions

Color System

Each section uses a distinct color palette from Tailwind's color spectrum:

  • Violet (primary QWAMI color)
  • Pink, Amber, Emerald, Cyan, Blue, Indigo, etc.

Palettes transition smoothly as users scroll between sections.

🎨 Design Philosophy

The landing page follows kwami.io's aesthetic:

  1. Informative - Clear, concise explanations
  2. Interactive - Smooth animations and transitions
  3. Modern - Clean typography and layout
  4. Accessible - Responsive and mobile-friendly
  5. On-brand - Consistent with KWAMI ecosystem

🔗 Links

🤝 Contributing

This is part of the KWAMI ecosystem. For contributions:

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Submit a pull request

See the main KWAMI repository for guidelines.

📄 License

Part of the KWAMI project. Check the main repository for license details.


Status: Production Ready
Version: 1.0.0
Network: Solana
Token: QWAMI

Built with 💜 for the KWAMI community

About

☀️ qwami.io | QWAMI token mint

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •