"If you had one shot, one prompt to code something super useful, would you capture it or would you let it flop?"
OneShotHack 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.
- One Prompt: Participants craft a single, comprehensive prompt
- Full Application: The prompt must generate a complete, working application
- AI-Powered: Prompts are run through AI LLMs (Claude, Cursor, etc.) to generate code
- Real Testing: Generated code is executed and evaluated for functionality
- Best Consumer App - Applications that solve everyday problems
- Best Commercial App - B2B or enterprise-focused solutions
- Best Developer Tool - Tools that help developers be more productive
- Most Creative - Unique and innovative applications
- Best UI/UX - Applications with exceptional user experience
- (More categories to be announced)
- Register - Sign up with GitHub authentication
- Craft Your Prompt - Develop your prompt locally on your own system
- Submit - Submit your prompt through our platform
- Choose LLM - Select which AI model should run your prompt (Claude, Cursor, etc.)
- Wait for Judging - Judges will run your prompt and evaluate the generated application
- Must be a single prompt (no follow-ups or iterations)
- Should specify all necessary components, features, and functionality
- Must result in a runnable application
- Can specify frameworks, libraries, and tools to use
- Environment Variables: Published list of available environment variables
- MCP Servers: List of available Model Context Protocol servers
- Execution Environment: Standardized environment for running generated code
- Testing Framework: Automated testing of generated applications
This landing page and submission platform is built with:
- Frontend: Next.js 15+ with TypeScript
- Backend: Convex (real-time, reactive database)
- Authentication: Better Auth with GitHub OAuth
- Components: shadcn/ui components
- Email: Resend for transactional emails
- Presence: Real-time user presence tracking
- Styling: Tailwind CSS
- Register and submit prompts
- Track submission status
- View results and feedback
- Review submissions
- Run prompts through LLMs
- Score and provide feedback
- Offer prizes for specific categories
- View relevant submissions
- Manage the hackathon
- Add categories and prizes
- Configure available LLMs and environments
- Node.js 18+
- pnpm package manager
- GitHub OAuth app credentials
- Convex account
# Clone the repository
git clone https://github.com/yourusername/oneshothack.git
cd oneshothack
# Install dependencies
pnpm install
# Copy environment variables
cp .env.example .env.local
# Update .env.local with your credentials
# Run development server
pnpm run devRequired environment variables:
CONVEX_DEPLOYMENT- Your Convex deploymentNEXT_PUBLIC_CONVEX_URL- Convex public URLBETTER_AUTH_SECRET- Authentication secretGITHUB_CLIENT_ID- GitHub OAuth client IDGITHUB_CLIENT_SECRET- GitHub OAuth client secret
Optional:
RESEND_API_KEY- For email functionalityRESEND_WEBHOOK_SECRET- For email event tracking
- Go to GitHub Developer Settings
- Create a new OAuth App
- Set callback URL:
http://localhost:3000/api/auth/callback/github - Copy credentials to
.env.local
# Set Better Auth secret
pnpx convex env set BETTER_AUTH_SECRET "your-secret"
# (Optional) Set Resend API key
pnpx convex env set RESEND_API_KEY "re_your-key"The application uses Convex for real-time data synchronization:
- Users: Hacker profiles and authentication
- Submissions: Prompt submissions and metadata
- Categories: Prize categories and rules
- Prizes: Sponsor-provided prizes
- Judges: Judge assignments and scores
- Requests: MCP server and environment variable requests
- Submit → Prompt enters review queue
- Review → Admins validate submission
- Execute → Judges run prompt through LLM
- Test → Generated code is executed
- Score → Judges evaluate functionality
- Results → Scores aggregated and winners selected
This is the official OneShotHack platform. For questions or issues:
- Open an issue on GitHub
- Contact the organizing team
- Join our Discord community
[License information to be added]
OneShotHack - Where one prompt changes everything.