{"id":29364181,"url":"https://github.com/successaje/yourz","last_synced_at":"2025-11-11T11:19:41.629Z","repository":{"id":303500410,"uuid":"1000864575","full_name":"successaje/YourZ","owner":"successaje","description":"YourZ is a Web3-native publishing platform where creators launch their own coins and turn blog posts into collectible NFTs. ","archived":false,"fork":false,"pushed_at":"2025-07-08T00:07:35.000Z","size":693,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-08T01:50:25.955Z","etag":null,"topics":["ipfs","marketplace","nft","uniswap-v4","zora"],"latest_commit_sha":null,"homepage":"https://yourz.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/successaje.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-12T12:45:25.000Z","updated_at":"2025-07-08T00:24:10.000Z","dependencies_parsed_at":"2025-07-08T01:50:34.665Z","dependency_job_id":"68c11fbc-4b04-4a4f-a42d-0d07e7d5d4af","html_url":"https://github.com/successaje/YourZ","commit_stats":null,"previous_names":["successaje/yourz"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/successaje/YourZ","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/successaje%2FYourZ","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/successaje%2FYourZ/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/successaje%2FYourZ/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/successaje%2FYourZ/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/successaje","download_url":"https://codeload.github.com/successaje/YourZ/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/successaje%2FYourZ/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278981518,"owners_count":26079640,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-08T02:00:06.501Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ipfs","marketplace","nft","uniswap-v4","zora"],"created_at":"2025-07-09T10:02:39.236Z","updated_at":"2025-10-08T17:09:46.134Z","avatar_url":"https://github.com/successaje.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# YourZ 🌟\n\n**Tokenize Your Words, Own Your Influence**\n\nYourZ is a revolutionary Web3 blogging platform that transforms content creation and consumption through blockchain technology. Built on Zora Protocol, YourZ enables creators to tokenize individual blog posts as ERC-20 tokens (Zora Coins), creating a new paradigm where readers become investors and content becomes tradeable assets.\n\n## 🎯 Vision\n\nYourZ flips the traditional content economy on its head. Instead of platforms taking cuts from creators and readers being passive consumers, YourZ creates a community-driven ecosystem where:\n\n- **Creators** monetize directly through token sales and royalties\n- **Readers** become stakeholders by investing in content they believe in\n- **Content** becomes a tradeable asset with real market value\n- **Communities** form around shared interests and financial incentives\n\n## ✨ Key Features\n\n### 🪙 Post Coins (ERC-20 Tokens)\n- **Individual Post Tokenization**: Every blog post can have its own ERC-20 token\n- **Creator Control**: Set mint prices, total supply, and royalty percentages\n- **Community Investment**: Readers buy tokens to support and profit from content\n- **Trading Platform**: Built-in marketplace for buying/selling post tokens\n\n### 📝 Web3-Native Blogging\n- **Decentralized Storage**: Content stored on IPFS for permanence\n- **Wallet Authentication**: No emails/passwords - sign in with your wallet\n- **ENS Integration**: Use your ENS name as your identity\n- **Token-Gated Features**: Exclusive content for token holders\n\n### 💰 Monetization \u0026 Rewards\n- **Direct Creator Earnings**: No platform fees, creators keep 90%+ of revenue\n- **Royalty Sharing**: Automatic payouts on secondary sales\n- **Investor Returns**: Early supporters earn when content gains value\n- **Transparent Economics**: All transactions visible on blockchain\n\n### 🤝 Community Features\n- **Collaborative Writing**: Co-author posts with revenue splits\n- **Curation Rewards**: Earn by discovering and promoting quality content\n- **Social Trading**: Follow successful investors and creators\n- **Governance**: Token holders can influence platform decisions\n\n## 🚀 How It Works\n\n### For Content Creators\n1. **Write**: Compose in our clean, Medium-style editor\n2. **Mint**: Create an ERC-20 token for your post with custom parameters\n3. **Earn**: Receive payments directly to your wallet when readers buy tokens\n4. **Grow**: Build a community of token holders who are invested in your success\n\n### For Content Investors\n1. **Discover**: Browse tokenized posts across various categories\n2. **Research**: Analyze creator history, token metrics, and community sentiment\n3. **Invest**: Buy tokens for posts you believe will gain value\n4. **Profit**: Earn royalties when others discover and invest in the same content\n\n### Example Scenario\n```\nCreator writes \"The Future of Web3\" → Mints 1000 tokens at 0.01 ETH each\nEarly Investor buys 10 tokens (cost: 0.1 ETH)\nPost goes viral → Secondary market resells tokens for 0.05 ETH each\nCreator earns: 10% royalty on every resale\nInvestor earns: 0.4 ETH profit (10 × 0.05 - 0.1)\n```\n\n## 🛠️ Technology Stack\n\n### Frontend\n- **Next.js 14** - React framework with App Router\n- **TypeScript** - Type-safe development\n- **Tailwind CSS** - Utility-first styling\n- **Framer Motion** - Smooth animations\n\n### Web3 \u0026 Blockchain\n- **Zora Protocol** - NFT and token infrastructure\n- **Zora Coins SDK** - ERC-20 token creation and management\n- **Wagmi** - React hooks for Ethereum\n- **RainbowKit** - Wallet connection UI\n- **Viem** - TypeScript interface for Ethereum\n\n### Backend \u0026 Storage\n- **Supabase** - Database and authentication\n- **IPFS** - Decentralized content storage\n- **NFT.Storage** - IPFS pinning service\n\n### Development Tools\n- **ESLint** - Code linting\n- **PostCSS** - CSS processing\n- **React Query** - Server state management\n\n## 📦 Installation \u0026 Setup\n\n### Prerequisites\n- Node.js 18+ \n- npm or yarn\n- Ethereum wallet (MetaMask, Rainbow, etc.)\n- Supabase account\n- IPFS/NFT.Storage account\n\n### Quick Start\n\n1. **Clone the repository**\n   ```bash\n   git clone https://github.com/yourusername/yourz.git\n   cd yourz\n   ```\n\n2. **Install dependencies**\n   ```bash\n   npm install\n   ```\n\n3. **Environment Setup**\n   Create a `.env.local` file:\n   ```env\n   # Wallet Connect\n   NEXT_PUBLIC_WALLET_CONNECT_PROJECT_ID=your_wallet_connect_project_id\n   \n   # Blockchain APIs\n   NEXT_PUBLIC_INFURA_API_KEY=your_infura_api_key\n   NEXT_PUBLIC_ALCHEMY_API_KEY=your_alchemy_api_key\n   \n   # Zora Protocol\n   NEXT_PUBLIC_ZORA_API_KEY=your_zora_api_key\n   \n   # Supabase\n   NEXT_PUBLIC_SUPABASE_URL=your_supabase_url\n   NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key\n   SUPABASE_SERVICE_ROLE_KEY=your_supabase_service_role_key\n   \n   # IPFS\n   NEXT_PUBLIC_NFT_STORAGE_API_KEY=your_nft_storage_api_key\n   ```\n\n4. **Database Setup**\n   ```bash\n   # Run Supabase migrations\n   npx supabase db push\n   ```\n\n5. **Start development server**\n   ```bash\n   npm run dev\n   ```\n\n6. **Open your browser**\n   Navigate to [http://localhost:3000](http://localhost:3000)\n\n## 📁 Project Structure\n\n```\nsrc/\n├── app/                    # Next.js App Router pages\n│   ├── (main)/            # Main application routes\n│   ├── api/               # API routes\n│   ├── coins/             # Post coins marketplace\n│   ├── dashboard/         # User dashboard\n│   ├── explore/           # Content discovery\n│   ├── marketplace/       # NFT marketplace\n│   ├── post/              # Individual post pages\n│   ├── profile/           # User profiles\n│   ├── trade/             # Trading interface\n│   └── write/             # Content creation\n├── components/            # React components\n│   ├── marketplace/       # Marketplace-specific components\n│   ├── post/              # Post-related components\n│   ├── providers/         # Context providers\n│   └── ui/                # Reusable UI components\n├── hooks/                 # Custom React hooks\n├── lib/                   # Utility libraries\n├── services/              # API and external services\n├── types/                 # TypeScript type definitions\n└── utils/                 # Helper functions\n```\n\n## 🔧 Configuration\n\n### Supported Networks\n- **Ethereum Mainnet** - Production environment\n- **Polygon** - Lower gas fees for testing\n- **Base** - Coinbase's L2 solution\n- **Optimism** - High-speed L2\n\n### Environment Variables\nSee the [Environment Setup](#environment-setup) section for required variables.\n\n## 🚀 Deployment\n\n### Vercel (Recommended)\n1. Connect your GitHub repository to Vercel\n2. Add environment variables in Vercel dashboard\n3. Deploy automatically on push to main branch\n\n### Manual Deployment\n```bash\nnpm run build\nnpm start\n```\n\n## 🤝 Contributing\n\nWe welcome contributions from the community! Here's how you can help:\n\n### Development Setup\n1. Fork the repository\n2. Create a feature branch: `git checkout -b feature/amazing-feature`\n3. Make your changes and add tests\n4. Commit: `git commit -m 'Add amazing feature'`\n5. Push: `git push origin feature/amazing-feature`\n6. Open a Pull Request\n\n### Contribution Areas\n- **Frontend Components** - React components and UI improvements\n- **Smart Contracts** - Zora Protocol integrations\n- **Backend APIs** - Supabase functions and database optimizations\n- **Documentation** - README, guides, and technical docs\n- **Testing** - Unit tests, integration tests, and E2E tests\n\n### Code Style\n- Follow TypeScript best practices\n- Use Prettier for code formatting\n- Write meaningful commit messages\n- Add JSDoc comments for complex functions\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🆘 Support\n\n\u003c!-- ### Documentation\n- [Feature Documentation](./docs/features/)\n- [API Reference](./docs/api/)\n- [Deployment Guide](./docs/deployment/) --\u003e\n\n### Community\n- [Discord]() - Join our community\n- [X]() - Follow for updates\n- [Blog](https://yourz.vercel.app) - Technical articles and tutorials\n\n### Issues\n- [GitHub Issues](https://github.com/successaje/yourz/issues) - Bug reports and feature requests\n- [Discussions](https://github.com/successaje/yourz/discussions) - General questions and ideas\n\n## 🎉 Acknowledgments\n\n- **Zora Protocol** - For the amazing Coin and NFT infrastructure\n- **Supabase** - For the powerful backend-as-a-service\n- **RainbowKit** - For the beautiful wallet connection experience\n- **IPFS** - For decentralized content storage\n- **Our Community** - For feedback, testing, and contributions\n\n---\n\n**Ready to tokenize your words and own your influence?** [Start creating on YourZ](https://yourz.vercel.app) 🚀\n\n*\"Don't just read – own the posts you love and earn when others discover them. Be more than a fan: be a stakeholder.\"*","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsuccessaje%2Fyourz","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsuccessaje%2Fyourz","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsuccessaje%2Fyourz/lists"}