{"id":39108709,"url":"https://github.com/un/oneshot","last_synced_at":"2026-01-17T19:38:14.000Z","repository":{"id":310542940,"uuid":"1039258381","full_name":"un/oneshot","owner":"un","description":"oneshot hackathon","archived":false,"fork":false,"pushed_at":"2025-12-16T21:25:23.000Z","size":250,"stargazers_count":1,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-22T09:29:27.110Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://oneshot-inky.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/un.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-08-16T20:21:54.000Z","updated_at":"2025-08-17T20:12:08.000Z","dependencies_parsed_at":"2025-08-18T20:03:29.355Z","dependency_job_id":"57c666c0-b538-4388-b191-842ca195398a","html_url":"https://github.com/un/oneshot","commit_stats":null,"previous_names":["un/oneshot"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/un/oneshot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/un%2Foneshot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/un%2Foneshot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/un%2Foneshot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/un%2Foneshot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/un","download_url":"https://codeload.github.com/un/oneshot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/un%2Foneshot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28517326,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T18:55:29.170Z","status":"ssl_error","status_checked_at":"2026-01-17T18:55:03.375Z","response_time":85,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":[],"created_at":"2026-01-17T19:38:13.300Z","updated_at":"2026-01-17T19:38:13.933Z","avatar_url":"https://github.com/un.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# OneShotHack 🚀\n\n\u003e **\"If you had one shot, one prompt to code something super useful, would you capture it or would you let it flop?\"**\n\n## About OneShotHack\n\nOneShotHack is a revolutionary hackathon where participants don't submit code – they submit a single, masterfully crafted prompt. The challenge? Create an entire functioning application with just one prompt to an AI LLM.\n\n### The Concept\n\n- **One Prompt**: Participants craft a single, comprehensive prompt\n- **Full Application**: The prompt must generate a complete, working application\n- **AI-Powered**: Prompts are run through AI LLMs (Claude, Cursor, etc.) to generate code\n- **Real Testing**: Generated code is executed and evaluated for functionality\n\n## 🏆 Prize Categories\n\n- **Best Consumer App** - Applications that solve everyday problems\n- **Best Commercial App** - B2B or enterprise-focused solutions\n- **Best Developer Tool** - Tools that help developers be more productive\n- **Most Creative** - Unique and innovative applications\n- **Best UI/UX** - Applications with exceptional user experience\n- *(More categories to be announced)*\n\n## 📋 Rules \u0026 Guidelines\n\n### How to Participate\n\n1. **Register** - Sign up with GitHub authentication\n2. **Craft Your Prompt** - Develop your prompt locally on your own system\n3. **Submit** - Submit your prompt through our platform\n4. **Choose LLM** - Select which AI model should run your prompt (Claude, Cursor, etc.)\n5. **Wait for Judging** - Judges will run your prompt and evaluate the generated application\n\n### Prompt Requirements\n\n- Must be a single prompt (no follow-ups or iterations)\n- Should specify all necessary components, features, and functionality\n- Must result in a runnable application\n- Can specify frameworks, libraries, and tools to use\n\n### What We Provide\n\n- **Environment Variables**: Published list of available environment variables\n- **MCP Servers**: List of available Model Context Protocol servers\n- **Execution Environment**: Standardized environment for running generated code\n- **Testing Framework**: Automated testing of generated applications\n\n## 🛠 Technical Stack\n\nThis landing page and submission platform is built with:\n\n- **Frontend**: Next.js 15+ with TypeScript\n- **Backend**: Convex (real-time, reactive database)\n- **Authentication**: Better Auth with GitHub OAuth\n- **Components**: shadcn/ui components\n- **Email**: Resend for transactional emails\n- **Presence**: Real-time user presence tracking\n- **Styling**: Tailwind CSS\n\n## 👥 User Roles\n\n### Hackers\n- Register and submit prompts\n- Track submission status\n- View results and feedback\n\n### Judges\n- Review submissions\n- Run prompts through LLMs\n- Score and provide feedback\n\n### Sponsors\n- Offer prizes for specific categories\n- View relevant submissions\n\n### Administrators\n- Manage the hackathon\n- Add categories and prizes\n- Configure available LLMs and environments\n\n## 🚀 Getting Started (Development)\n\n### Prerequisites\n\n- Node.js 18+\n- pnpm package manager\n- GitHub OAuth app credentials\n- Convex account\n\n### Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/yourusername/oneshothack.git\ncd oneshothack\n\n# Install dependencies\npnpm install\n\n# Copy environment variables\ncp .env.example .env.local\n# Update .env.local with your credentials\n\n# Run development server\npnpm run dev\n```\n\n### Environment Setup\n\nRequired environment variables:\n\n- `CONVEX_DEPLOYMENT` - Your Convex deployment\n- `NEXT_PUBLIC_CONVEX_URL` - Convex public URL\n- `BETTER_AUTH_SECRET` - Authentication secret\n- `GITHUB_CLIENT_ID` - GitHub OAuth client ID\n- `GITHUB_CLIENT_SECRET` - GitHub OAuth client secret\n\nOptional:\n- `RESEND_API_KEY` - For email functionality\n- `RESEND_WEBHOOK_SECRET` - For email event tracking\n\n### Setting up GitHub OAuth\n\n1. Go to [GitHub Developer Settings](https://github.com/settings/developers)\n2. Create a new OAuth App\n3. Set callback URL: `http://localhost:3000/api/auth/callback/github`\n4. Copy credentials to `.env.local`\n\n### Convex Setup\n\n```bash\n# Set Better Auth secret\npnpx convex env set BETTER_AUTH_SECRET \"your-secret\"\n\n# (Optional) Set Resend API key\npnpx convex env set RESEND_API_KEY \"re_your-key\"\n```\n\n## 📊 Database Schema\n\nThe application uses Convex for real-time data synchronization:\n\n- **Users**: Hacker profiles and authentication\n- **Submissions**: Prompt submissions and metadata\n- **Categories**: Prize categories and rules\n- **Prizes**: Sponsor-provided prizes\n- **Judges**: Judge assignments and scores\n- **Requests**: MCP server and environment variable requests\n\n## 🔄 Submission Workflow\n\n1. **Submit** → Prompt enters review queue\n2. **Review** → Admins validate submission\n3. **Execute** → Judges run prompt through LLM\n4. **Test** → Generated code is executed\n5. **Score** → Judges evaluate functionality\n6. **Results** → Scores aggregated and winners selected\n\n## 🤝 Contributing\n\nThis is the official OneShotHack platform. For questions or issues:\n\n- Open an issue on GitHub\n- Contact the organizing team\n- Join our Discord community\n\n## 📜 License\n\n[License information to be added]\n\n---\n\n**OneShotHack** - Where one prompt changes everything.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fun%2Foneshot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fun%2Foneshot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fun%2Foneshot/lists"}