- About
- Features
- Technology Stack
- Prerequisites
- Installation
- Configuration
- Development
- Testing
- Deployment
- Project Structure
- Contributing
- License
- Contact
Beenzer DAO is a fully decentralized autonomous organization built on the Solana blockchain. It empowers community members to participate in governance, stake tokens, mint NFTs, and trade in a decentralized marketplace. With a focus on transparency, speed, and low transaction costs, Beenzer DAO leverages Solana's high-performance infrastructure to deliver a seamless Web3 experience.
- 🚀 Lightning Fast: Built on Solana for sub-second transaction finality
- 💰 Low Fees: Minimal transaction costs compared to other blockchains
- 🗳️ True Governance: Community-driven decision making through DAO voting
- 🔒 Secure: Leveraging Solana's proven security infrastructure
- 🌐 Decentralized: No central authority, fully community-owned
Create and mint unique NFTs directly on the Solana blockchain. Our minting platform supports:
- Custom metadata and attributes
- Real-time minting status updates
- Integration with Metaplex standards
- Countdown timers for minting events
Stake your tokens to earn rewards and participate in governance:
- Flexible staking periods
- Real-time APY calculations
- Automated reward distribution
- View staking contracts and holder information
Participate in DAO governance with democratic voting:
- Create and vote on proposals
- Real-time vote counting
- Motion history and results tracking
- Community chat for discussions
- Transparent voting records on-chain
Buy, sell, and trade NFTs in a decentralized marketplace:
- Browse community NFT collections
- Secure peer-to-peer transactions
- Real-time price updates
- Creator royalties support
Comprehensive analytics and insights:
- Token holder distribution
- Transaction history and volume
- Real-time network statistics
- Interactive charts and visualizations
- Token supply and circulation metrics
Personalized user experience:
- Wallet integration and management
- NFT collection showcase
- Transaction history
- Governance participation tracking
- Customizable profile settings
- Vue.js 3 - Progressive JavaScript framework
- TypeScript - Type-safe JavaScript
- TailwindCSS - Utility-first CSS framework
- Vue Router - Official router for Vue.js
- Vuex - State management pattern
- @solana/web3.js - Solana JavaScript API
- @project-serum/anchor - Framework for Solana smart contracts
- @solana/spl-token - Solana Program Library for tokens
- @metaplex-foundation/js - NFT standard on Solana
Supports 15+ popular Solana wallets:
- 👻 Phantom
- 🔥 Solflare
- 🦊 Brave Wallet
- 💼 Ledger
- 🌟 Glow
- 🏦 Coinbase Wallet
- 📱 Trust Wallet
- ⚡ Slope
- And more...
- Socket.io - Real-time bidirectional communication
- ApexCharts - Modern charting library
- Vue-ChartJS - Vue wrapper for Chart.js
- Jest - Unit testing framework
- Cypress - End-to-end testing
- ESLint - Code linting
- Vue CLI - Standard tooling for Vue.js
Before you begin, ensure you have the following installed:
- Node.js (v16.x or higher)
- npm (v8.x or higher) or yarn (v1.22.x or higher)
- Git
- A Solana wallet (Phantom, Solflare, etc.)
- Clone the repository
git clone https://github.com/yourusername/beenzer-dao.git
cd beenzer-dao- Install dependencies
npm installor using yarn:
yarn install- Create environment configuration
Create a .env.sample file in the root directory:
# Solana Network Configuration
VUE_APP_SOLANA_NETWORK=devnet
VUE_APP_SOLANA_RPC_ENDPOINT=https://api.devnet.solana.com
# Socket.io Server
VUE_APP_SOCKET_ENDPOINT=wss://your-backend-server.com
# Metaplex Configuration
VUE_APP_METAPLEX_ENDPOINT=https://api.metaplex.solana.com
# Application Settings
VUE_APP_TOKEN_MINT_ADDRESS=your_token_mint_address_here
VUE_APP_PROGRAM_ID=your_program_id_here- Copy to active environment file
cp .env.sample .env- Update configuration values
Edit .env with your specific configuration:
- Replace
VUE_APP_SOCKET_ENDPOINTwith your backend WebSocket server - Update Solana RPC endpoint for mainnet deployment
- Add your token mint address and program ID
⚠️ Note: Never commit your.envfile with sensitive credentials to version control.
Run the development server with hot-reload:
npm run serveThe application will be available at http://localhost:8080
Compile and minify for production:
npm run buildThe optimized files will be generated in the dist/ directory.
Run ESLint to check and fix code issues:
npm run lintRun unit tests with Jest:
npm run test:unitRun E2E tests with Cypress:
npm run test:e2eFor interactive Cypress testing:
npm run test:e2e:openGenerate test coverage report:
npm run test:unit -- --coverageThe project includes a deployment script (deploy.sh) for easy deployment:
./deploy.shThis script will:
- Build the production bundle
- Navigate to the
dist/directory - Initialize a git repository
- Commit the build files
- Deploy to your configured hosting service
- Build the project
npm run build- Deploy to hosting service
Deploy the dist/ folder to your preferred hosting:
- Vercel:
vercel deploy - Netlify:
netlify deploy --prod - AWS S3:
aws s3 sync dist/ s3://your-bucket - GitHub Pages: Configure in repository settings
For different environments:
# Development
npm run build -- --mode development
# Staging
npm run build -- --mode staging
# Production
npm run build -- --mode productionbeenzer-dao/
├── public/ # Static assets
│ ├── index.html # HTML template
│ ├── favicon.ico # App favicon
│ └── logo.png # App logo
├── src/
│ ├── assets/ # Images, fonts, and global CSS
│ │ └── css/ # Stylesheets (TailwindCSS)
│ ├── components/ # Reusable Vue components
│ │ ├── governance/ # Governance-related components
│ │ ├── minting/ # NFT minting components
│ │ ├── modules/ # Shared modules (wallets, modals)
│ │ ├── profile/ # User profile components
│ │ └── staking/ # Staking components
│ ├── router/ # Vue Router configuration
│ │ └── index.ts # Route definitions
│ ├── services/ # Business logic and API calls
│ │ ├── nfts/ # NFT-related services
│ │ ├── sockets/ # Socket.io integration
│ │ ├── store/ # Vuex store modules
│ │ ├── token/ # Token services
│ │ └── wallets/ # Wallet integration services
│ ├── types/ # TypeScript type definitions
│ ├── utils/ # Utility functions
│ ├── views/ # Page-level components
│ │ ├── GovernanceView.vue
│ │ ├── MarketplaceView.vue
│ │ ├── MintingView.vue
│ │ ├── ProfileView.vue
│ │ ├── StakingView.vue
│ │ └── StatsView.vue
│ ├── App.vue # Root component
│ ├── main.ts # Application entry point
│ └── registerServiceWorker.ts # PWA service worker
├── tests/ # Test files
│ ├── unit/ # Unit tests
│ └── e2e/ # End-to-end tests
├── config/ # Configuration files
│ ├── calendar.json # Roadmap configuration
│ └── motions.json # Governance motions
├── .browserslistrc # Browser compatibility
├── .eslintrc.js # ESLint configuration
├── .gitignore # Git ignore rules
├── babel.config.js # Babel configuration
├── cypress.json # Cypress configuration
├── deploy.sh # Deployment script
├── jest.config.js # Jest configuration
├── package.json # Dependencies and scripts
├── postcss.config.js # PostCSS configuration
├── tailwind.config.js # TailwindCSS configuration
├── tsconfig.json # TypeScript configuration
├── vue.config.js # Vue CLI configuration
└── webpack.config.js # Webpack configuration
We welcome contributions from the community! Here's how you can help:
- Fork the repository
git clone https://github.com/yourusername/beenzer-dao.git- Create a feature branch
git checkout -b feature/amazing-feature-
Make your changes
- Write clean, maintainable code
- Follow the existing code style
- Add tests for new features
- Update documentation as needed
-
Commit your changes
Follow our commit message convention with emojis:
git commit -m "✨ Add amazing new feature"
git commit -m "🐛 Fix critical bug in staking"
git commit -m "📚 Update documentation"
git commit -m "🎨 Improve UI/UX"
git commit -m "♻️ Refactor wallet connection logic"Commit Emoji Guide:
- ✨
:sparkles:- New feature - 🐛
:bug:- Bug fix - 📚
:books:- Documentation - 🎨
:art:- UI/UX improvements - ♻️
:recycle:- Code refactoring - ⚡
:zap:- Performance improvements - 🔒
:lock:- Security fixes - 🧪
:test_tube:- Tests
- Push to your fork
git push origin feature/amazing-feature- Open a Pull Request
- Provide a clear description of changes
- Reference any related issues
- Ensure all tests pass
- Request review from maintainers
- Code Style: Follow the existing code style and use ESLint
- Testing: Write unit tests for new features
- Documentation: Update README and inline comments
- Commits: Use semantic commit messages with emojis
- Pull Requests: Keep PRs focused and atomic
Found a bug or have a suggestion? Please open an issue:
- Check if the issue already exists
- Use a clear and descriptive title
- Provide detailed steps to reproduce (for bugs)
- Include screenshots if applicable
- Specify your environment (browser, OS, wallet)
This project is licensed under the MIT License - see the LICENSE file for details.
MIT License allows you to:
- ✅ Use commercially
- ✅ Modify
- ✅ Distribute
- ✅ Private use
With the condition that you:
- 📄 Include the license and copyright notice
- Website: https://dao.beenzer.app
- GitHub: https://github.com/yourusername/beenzer-dao
- Documentation: Coming soon
- Discord: Join our community (Link TBA)
- Twitter: Follow us for updates (Link TBA)
- Telegram: Join the discussion (Link TBA)
For support and questions:
- 📧 Email: [email protected]
- 💬 Discord: Community support channel
- 🐛 GitHub Issues: Report bugs
Special thanks to:
- Solana Foundation - For building an incredible blockchain platform
- Metaplex - For NFT standards and tooling
- Vue.js Team - For the amazing framework
- Our Community - For continuous support and feedback
- All Contributors - For making this project better
If you discover a security vulnerability, please email us at:
Please do not open a public issue for security vulnerabilities.
- Never share your private keys
- Always verify transaction details before signing
- Use hardware wallets for large holdings
- Keep your wallet software up to date
- Be cautious of phishing attempts
Upcoming features and improvements:
- Multi-signature wallet support
- Advanced governance proposals
- Mobile application (iOS/Android)
- Layer 2 scaling integration
- Enhanced analytics dashboard
- DAO treasury management
- NFT collections and galleries
- Cross-chain bridge integration
Check our Issues page for more details.
Made with ❤️ by the Beenzer Community
⭐ Star this repository if you find it helpful!