Find your space nearby.
Discover nearby rooms and flats with real-time availability, smart filters, and map-first exploration.
Repository: https://github.com/arundada9000/roomeo
Hosted at: https://roomeo.vercel.app
Arun Neupane — Full-Stack Developer from Butwal, Nepal
| Portfolio | arunneupane.netlify.app |
| GitHub | @arundada9000 |
| arundada9000 | |
| arunneupane0000@gmail.com | |
| CTO @ | Sajilo Digital |
| Vice Secretary @ | Code for Change Rupandehi |
npm install # Install dependencies
npx prisma db push # Push database schema
npm run dev # Start dev server at http://localhost:3000See how-to-run.md for device-specific setup or docs/development.md for full guide.
| Layer | Technology |
|---|---|
| Framework | Next.js 16 (App Router) |
| Language | TypeScript (strict) |
| Styling | TailwindCSS 4 |
| UI Library | shadcn/ui + Base UI |
| Database | PostgreSQL 16+ / PostGIS |
| ORM | Prisma 7 |
| Maps | Leaflet + React Leaflet 5 |
| Auth | Better Auth 1.x |
| State | Zustand 5 + TanStack Query 5 |
| Animations | Framer Motion 12 |
| Icons | Lucide React + Custom PNG icons |
| Role | Capabilities |
|---|---|
| Admin | Manage users, landlords, listings; moderate content; view analytics |
| Landlord | Create properties/units, upload media, manage availability |
| User | Browse map, filter rooms, save favorites, contact landlords |
roomeo/
├── prisma/ # Database schema & seed
│ ├── schema.prisma # Models: User, Property, Unit, Media, etc.
│ └── seed.ts # Seed script with faker data
├── public/
│ ├── icons-for-rooms/ # Room-type PNG icons (3 variant sets)
│ ├── rooms/ # Sample room photos
│ └── uploads/ # User uploads
├── src/
│ ├── app/ # Next.js App Router pages
│ │ ├── explore/ # Main map page (Leaflet + bottom sheet)
│ │ ├── rooms/ # Grid listing page with filters
│ │ ├── units/[id]/ # Unit detail page
│ │ ├── hub/ # Landing/dashboard page
│ │ ├── admin/ # Admin dashboard & management
│ │ ├── landlord/ # Landlord dashboard & property mgmt
│ │ └── ...
│ ├── components/
│ │ ├── map/ # Map components (explore-map, filter-modal)
│ │ ├── listing/ # Unit listing card
│ │ ├── shared/ # Navbar, Footer, FilterPanel, etc.
│ │ ├── admin/ # Admin-specific components
│ │ └── ui/ # shadcn/ui primitives
│ ├── stores/ # Zustand state stores
│ │ └── map-store.ts # Map state, filters, view mode
│ ├── types/ # Shared TypeScript types & enums
│ └── lib/ # Utilities (prisma, auth, etc.)
├── docs/ # Documentation
│ ├── architecture.md # System architecture
│ ├── components.md # Component documentation
│ ├── data-model.md # Database schema
│ ├── development.md # Development setup guide
│ ├── filters.md # Filtering system
│ ├── icons.md # Room-type icons
│ ├── routes.md # Route structure
│ └── seed-users.md # Seed user credentials
└── design/ # UI design references
| Route | Description |
|---|---|
/ |
Landing page |
/welcome |
Onboarding splash |
/explore |
Map-first exploration with bottom sheet |
/rooms |
Grid listing with sidebar filters |
/units/[id] |
Unit detail with gallery & contact |
/login |
Sign in |
/signup |
Create account |
/hub |
Dashboard (recent listings, stats) |
/profile |
User profile & settings |
/profile/settings |
Account settings |
/favorites |
Saved favorites |
/about |
About page |
/contact |
Contact form |
/blog |
Blog listing |
/blog/[slug] |
Blog post |
/pricing |
Pricing plans |
/careers |
Careers page |
/terms |
Terms of service |
/privacy |
Privacy policy |
/cookies |
Cookie policy |
/admin |
Admin dashboard |
/landlord |
Landlord dashboard & property mgmt |
MIT — see LICENSE.
Repository: https://github.com/arundada9000/roomeo
Hosted at: https://roomeo.vercel.app
Built by Arun Neupane
