{"id":28352345,"url":"https://github.com/raven-house/aztec-nextjs-starter","last_synced_at":"2025-07-12T21:33:54.459Z","repository":{"id":293484767,"uuid":"983934388","full_name":"raven-house/aztec-nextjs-starter","owner":"raven-house","description":"Aztec NextJS starter code","archived":false,"fork":false,"pushed_at":"2025-06-08T08:38:40.000Z","size":9218,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-11T23:05:34.988Z","etag":null,"topics":["aztec","aztec-nextjs-starter","easy-private-voting-contract","privacy","private-voting-contract","wallet-setups","web3","zero-knowledge"],"latest_commit_sha":null,"homepage":"https://create-aztec-app.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/raven-house.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-05-15T06:26:19.000Z","updated_at":"2025-06-11T10:46:22.000Z","dependencies_parsed_at":null,"dependency_job_id":"fd7c41e4-1334-4626-94b5-495d0a312687","html_url":"https://github.com/raven-house/aztec-nextjs-starter","commit_stats":null,"previous_names":["raven-house/aztec-nextjs-starter"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/raven-house/aztec-nextjs-starter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raven-house%2Faztec-nextjs-starter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raven-house%2Faztec-nextjs-starter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raven-house%2Faztec-nextjs-starter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raven-house%2Faztec-nextjs-starter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/raven-house","download_url":"https://codeload.github.com/raven-house/aztec-nextjs-starter/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raven-house%2Faztec-nextjs-starter/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265059272,"owners_count":23705204,"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":["aztec","aztec-nextjs-starter","easy-private-voting-contract","privacy","private-voting-contract","wallet-setups","web3","zero-knowledge"],"created_at":"2025-05-27T23:06:58.966Z","updated_at":"2025-07-12T21:33:54.430Z","avatar_url":"https://github.com/raven-house.png","language":"TypeScript","funding_links":[],"categories":["Coding"],"sub_categories":["Boilerplates"],"readme":"# Aztec Network Starter Repository\n\nA modern Next.js starter template with Aztec Network integration for building privacy-focused web3 applications.\n\n## Overview\n\nThis starter repository provides a foundation for developing decentralized applications on Aztec Network, featuring wallet integration for both Azguard and Obsidion wallets, along with a complete example of a private voting contract implementation.\n\n\n[Checkout complete walkthrough on Youtube](https://www.youtube.com/live/6BviS0dGoEw)\n## Features\n\n- **Wallet Integration**: Ready-to-use connections with Azguard and Obsidion wallets\n- **Private Voting Contract**: Complete example of a privacy-preserving voting system\n- **Modern UI**: Clean, responsive interface built with Shadcn UI components\n- **Network Information**: Real-time Aztec Network status display\n- **Dark Mode**: Sleek dark theme optimized for developers\n\n## Prerequisites\n\n- Node.js 22+\n- NPM or Yarn\n- Access to Aztec Network (Testnet or Local Sandbox)\n- Azguard and/or Obsidion wallet extensions installed in your browser\n\n## Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/raven-house/aztec-nextjs-starter.git\n\n# Navigate to the project directory\ncd aztec-starter\n\n# Install dependencies\nnpm install\n# or\nyarn install\n\n# Start the development server\nnpm run dev\n# or\nyarn dev\n```\n\n## Contract setup\n\n# Commands\n\nInstall All dependencies\n\n```bash\naztec-nargo build\n```\n\nCompile contracts\n\n```bash\naztec-nargo compile\n```\n\nGenerate contract artifacts\n\n```bash\naztec codegen -o ../src/artifacts target --force\n```\n\nRun test cases(Trixie)\n\n```bash\naztec test\n```\n\n\n**NOTE:** You need to register your contract first using script `bun run register-contract` before trying deployment using Obsidion wallet.\n\n\n## Environment Setup\n\nCreate a `.env.local` file in the root directory with the following variables:\nNEXT_PUBLIC_TESTNET_NODE_URL=https://aztec-alpha-testnet-fullnode.zkv.xyz\nAPP_MODE=SANDBOX # or TESTNET for testnet deployment\n\n## Using the Starter\n\n### Wallet Connection\n\n1. Click the \"Connect Wallet\" button in the header\n2. Select either Azguard or Obsidion wallet\n3. Approve the connection request in your wallet\n\nThe application stores the connected wallet information in the global context, making it available throughout the application.\n\n### Private Voting Contract Example\n\nThe starter includes a complete example of a private voting contract with the following functionalities:\n\n1. **Deploy Contract**: Deploy the EasyPrivateVoting contract to Aztec Network\n2. **Register Contract Class**: Register the contract class before deployment if necessary\n3. **Cast Vote**: Cast a private vote (encrypted on-chain)\n4. **Check Votes**: View the current vote count without revealing individual votes\n5. **End Voting**: Finalize the voting process\n\n### Contract Details\n\nThe `EasyPrivateVoting` contract demonstrates privacy-preserving voting where:\n\n- Votes are encrypted and private\n- Only vote tallies are visible, not individual votes\n- Only the admin can end the voting process\n- Results are verifiably correct without compromising privacy\n\n\u003c!-- ## Project Structure\n\n└── src/\n├── app/ # Next.js pages and layouts\n├── artifacts/ # Contract artifacts\n├── components/ # React components\n│ ├── ui/ # UI components from shadcn\n│ └── wallet/ # Wallet-specific components\n├── constants/ # Configuration constants\n├── contexts/ # React contexts\n└── lib/ # Utility functions --\u003e\n\n## Technologies Used\n\n- **Frontend**: Next.js, React, TailwindCSS\n- **Smart Contracts**: Aztec Network, Noir language\n- **Wallet Integration**: Azguard and Obsidion wallets\n- **UI Components**: Shadcn UI library\n- **State Management**: React Context API\n\n## Development Mode\n\nThe application can run in two modes:\n\n- **SANDBOX**: For local development (default)\n- **TESTNET**: For deploying to Aztec Testnet\n\nChange the `APP_MODE` environment variable to switch between modes.\n\n## Resources\n\n- [Aztec Network Documentation](https://docs.aztec.network/)\n- [Noir Language Documentation](https://noir-lang.org/)\n- [Obsidion Wallet Documentation](https://docs.obsidion.xyz/)\n\n## License\n\nMIT\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n\n\n\n# Resources\n1. Obsidion Wallet: https://app.obsidion.xyz/\n\n\n\n\n# Notes\nWhat is Nargo ?\ndependency management, package management tool\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraven-house%2Faztec-nextjs-starter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fraven-house%2Faztec-nextjs-starter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraven-house%2Faztec-nextjs-starter/lists"}