Every Place Has a Secret
LegendVault is a location-based urban legend social platform where users submit, discover, and explore creepy stories tied to real-world locations.
LegendVault lets anyone drop a pin on the map and attach an urban legend to it. Whether it's a haunted house on your street, a cryptid sighting in the woods, or a cursed location from local folklore, LegendVault is where those stories live. Users can upvote legends, leave comments, and explore an interactive map of eerie pins from around the world.
| Layer | Technology |
|---|---|
| Frontend | Next.js 14, TypeScript, Tailwind CSS, shadcn/ui |
| Database | AWS DynamoDB |
| Auth | Clerk |
| Map | Mapbox GL JS |
| Deployment | Vercel |
- Submit urban legends tied to a real-world location
- Browse a dark, atmospheric feed of legends sorted by newest or most upvoted
- Filter legends by category: Haunted, Cryptid, Paranormal, Disappearance, Cursed
- Explore an interactive map with custom eerie location pins
- Upvote and comment on legends
- Public user profiles showing all submitted legends
Legends Table --> legendId (PK), createdAt (SK), title, story, authorId, location, category, upvotes, commentCount
Users Table --> userId (PK), username, email, bio, avatarUrl, legendsSubmitted, joinedAt
Votes Table --> userId (PK), legendId (SK), createdAt
Comments Table --> legendId (PK), commentId (SK), authorId, authorName, content, createdAt
- Node.js 18+
- AWS Account with DynamoDB access
- Vercel account
- Clerk account
- Mapbox account
git clone https://github.com/yourusername/legendvault
cd legendvault
npm installCreate a .env.local file in the root directory:
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=your_clerk_publishable_key
CLERK_SECRET_KEY=your_clerk_secret_key
AWS_REGION=your_aws_region
AWS_ACCESS_KEY_ID=your_aws_access_key
AWS_SECRET_ACCESS_KEY=your_aws_secret_key
NEXT_PUBLIC_MAPBOX_TOKEN=your_mapbox_tokennpm run devOpen http://localhost:3000 to view the app.
This project is deployed on Vercel. To deploy your own instance:
- Push your repo to GitHub
- Import the project on vercel.com
- Add your environment variables in the Vercel dashboard
- Deploy
Built for the H0: Hack the Zero Stack Hackathon for Track 3: Million-scale Global App.
MIT