{"id":18484348,"url":"https://github.com/giveth/devouch-fe","last_synced_at":"2025-06-16T03:03:49.034Z","repository":{"id":234537368,"uuid":"789104060","full_name":"Giveth/DeVouch-FE","owner":"Giveth","description":"Front-end repository of the DeVouch project","archived":false,"fork":false,"pushed_at":"2025-01-29T21:15:18.000Z","size":1234,"stargazers_count":24,"open_issues_count":12,"forks_count":2,"subscribers_count":9,"default_branch":"develop","last_synced_at":"2025-02-26T09:41:43.992Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://de-vouch-fe-givethio.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Giveth.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2024-04-19T17:53:43.000Z","updated_at":"2024-11-26T14:35:17.000Z","dependencies_parsed_at":"2024-05-30T14:43:21.034Z","dependency_job_id":"f2722ed8-a367-4ddf-aea0-2ab22bc44ac4","html_url":"https://github.com/Giveth/DeVouch-FE","commit_stats":null,"previous_names":["giveth/devouch-fe"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Giveth%2FDeVouch-FE","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Giveth%2FDeVouch-FE/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Giveth%2FDeVouch-FE/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Giveth%2FDeVouch-FE/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Giveth","download_url":"https://codeload.github.com/Giveth/DeVouch-FE/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247902831,"owners_count":21015527,"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","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":[],"created_at":"2024-11-06T12:39:26.855Z","updated_at":"2025-06-16T03:03:49.014Z","avatar_url":"https://github.com/Giveth.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DeVouch Frontend\n\n## 1. Project Overview\n\n### Purpose\n\nDeVouch is a decentralized verification and attestation platform built on the Ethereum blockchain. The frontend application provides a user-friendly interface for creating, managing, and verifying attestations using the Ethereum Attestation Service (EAS).\n\n### Key Features\n\n-   Web3 wallet integration for secure authentication\n-   Attestation creation and management\n-   Real-time verification of attestations\n-   Responsive and modern UI built with Next.js and Tailwind CSS\n\n### Live Links\n\n-   Production: [https://devouch.xyz/](https://devouch.xyz/)\n-   Staging: [https://staging.devouch.xyz/](https://staging.devouch.xyz/)\n\n## 2. Architecture Overview\n\n### System Diagram\n\n```mermaid\ngraph TD\n    A[Frontend] --\u003e B[Ethereum Blockchain]\n    A --\u003e C[Ethereum Attestation Service]\n    A --\u003e D[Web3Modal]\n    A --\u003e E[React Query]\n```\n\n### Tech Stack\n\n-   **Framework**: Next.js 14.2.3\n-   **UI**: React 18, Tailwind CSS\n-   **State Management**: React Query\n-   **Web3 Integration**:\n    -   Wagmi\n    -   Viem\n    -   Web3Modal\n-   **Attestation Service**: EAS SDK\n-   **Language**: TypeScript\n\n### Data Flow\n\n1. User connects wallet via Web3Modal\n2. Frontend interacts with EAS SDK for attestation operations\n3. React Query manages data fetching and caching\n4. Wagmi handles blockchain interactions\n5. UI components render attestation data and user interactions\n\n## 3. Getting Started\n\n### Prerequisites\n\n-   Node.js (v18 or higher)\n-   Yarn package manager\n-   Web3 wallet (MetaMask, WalletConnect, etc.)\n\n### Installation Steps\n\n1. Clone the repository:\n\n    ```bash\n    git clone https://github.com/your-org/devouch-fe.git\n    cd devouch-fe\n    ```\n\n2. Install dependencies:\n\n    ```bash\n    yarn install\n    ```\n\n3. Copy environment variables:\n\n    ```bash\n    cp .env.example .env.local\n    ```\n\n4. Update environment variables in `.env.local` with your configuration\n\n### Configuration\n\nRequired environment variables:\n\n-   `NEXT_PUBLIC_WALLET_CONNECT_PROJECT_ID`: Your WalletConnect project ID\n-   `NEXT_PUBLIC_EAS_CONTRACT_ADDRESS`: EAS contract address\n-   `NEXT_PUBLIC_SCHEMA_REGISTRY_ADDRESS`: Schema registry contract address\n\n## 4. Usage Instructions\n\n### Running the Application\n\nDevelopment mode:\n\n```bash\nyarn dev\n```\n\nProduction build:\n\n```bash\nyarn build\nyarn start\n```\n\n### Testing\n\nRun linting:\n\n```bash\nyarn lint\n```\n\n### Common Tasks\n\n-   Creating new attestations\n-   Verifying existing attestations\n-   Managing wallet connections\n-   Viewing attestation history\n\n## 5. Deployment Process\n\n### Environments\n\n-   Development: Local development\n-   Staging: Pre-production testing\n-   Production: Live application\n\n### Deployment Steps\n\n1. Build the application:\n\n    ```bash\n    yarn build\n    ```\n\n2. Deploy to your hosting platform (e.g., Vercel)\n\n### CI/CD Integration\n\n-   Automated builds on main branch\n-   Pre-deployment checks\n-   Environment-specific configurations\n\n## 6. Troubleshooting\n\n### Common Issues\n\n1. **Wallet Connection Issues**\n\n    - Clear browser cache\n    - Ensure wallet is properly configured\n    - Check network connectivity\n\n2. **Attestation Creation Failures**\n    - Verify wallet has sufficient funds\n    - Check network congestion\n    - Ensure correct contract addresses\n\n### Logs and Debugging\n\n-   Browser console logs\n-   Network request monitoring\n-   Transaction status tracking\n\n## Contributing\n\nPlease read [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of conduct and the process for submitting pull requests.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgiveth%2Fdevouch-fe","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgiveth%2Fdevouch-fe","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgiveth%2Fdevouch-fe/lists"}