Skip to content

CherukuriPavanKumar/plot-management

Repository files navigation

Multi-Project Plot Management Dashboard

A production-quality SaaS demo for Webbheads β€” showcasing premium real estate management with investor-ready UI/UX.

Status Next.js TypeScript


🎯 Project Overview

Purpose: Demo SaaS for managing real estate projects, plots, and customers
Target: Real estate developers, plot managers, sales teams
Design Philosophy: Premium Β· Minimal Β· Trust-worthy Β· Client-Ready

Think: Notion + Airbnb Admin + Real Estate CRM


✨ Key Features

🏠 Public Landing Page

  • Modern hero section with gradient accents
  • Feature showcase with premium cards
  • Location highlights with trust indicators
  • High-conversion CTAs

πŸ“Š Admin Dashboard

  • Overview: Revenue metrics, project stats with animated cards
  • Projects: Grid view with progress indicators and revenue tracking
  • Plot Management (Core Feature):
    • Color-coded status grid (Available/Reserved/Sold)
    • Advanced filtering and search
    • Real-time stats overview
    • Smooth animations and hover states
  • Clean Navigation: Sidebar with active state indicators

🎨 Design System

Color Palette

  • Primary: Blue (#0ea5e9) - Professional, trust-worthy
  • Status Colors:
    • Available: Emerald (#10b981)
    • Reserved: Amber (#f59e0b)
    • Sold: Rose (#ef4444)
  • Neutrals: Clean grays for backgrounds and text

Typography

  • Display: 60px, bold, -2% letter spacing
  • Headings: 36px β†’ 24px scale
  • Body: 15px for optimal readability
  • Small: 13px for metadata

Spacing & Layout

  • Section spacing: 96px
  • Card padding: 24px
  • Element gap: 16px
  • Max content width: 1600px

🧱 Tech Stack

Category Technology
Framework Next.js 15 (App Router)
Language TypeScript
Styling Tailwind CSS v4
UI Components shadcn/ui
Animations Framer Motion
Icons Lucide React
Charts Recharts
Data Mock API (realistic data)

πŸš€ Getting Started

Prerequisites

  • Node.js 18+
  • npm or pnpm

Installation

# Install dependencies
npm install

# Run development server
npm run dev

# Build for production
npm run build

Access Points


πŸ“‚ Project Structure

src/
β”œβ”€β”€ app/
β”‚   β”œβ”€β”€ (dashboard)/           # Admin routes with sidebar layout
β”‚   β”‚   β”œβ”€β”€ overview/          # Dashboard homepage
β”‚   β”‚   β”œβ”€β”€ projects/          # Project management
β”‚   β”‚   β”‚   └── [id]/          # Project details (dynamic)
β”‚   β”‚   β”œβ”€β”€ plots/             # Plot inventory (core feature)
β”‚   β”‚   β”œβ”€β”€ customers/         # Customer management
β”‚   β”‚   β”œβ”€β”€ documents/         # Document repository
β”‚   β”‚   β”œβ”€β”€ analytics/         # Analytics dashboard
β”‚   β”‚   └── settings/          # App settings
β”‚   β”œβ”€β”€ (marketing)/           # Public routes
β”‚   β”‚   └── page.tsx           # Landing page
β”‚   └── globals.css            # Global styles
β”œβ”€β”€ components/
β”‚   β”œβ”€β”€ layout/                # Sidebar, Header
β”‚   β”œβ”€β”€ projects/              # ProjectCard
β”‚   β”œβ”€β”€ plots/                 # PlotGrid, PlotStatusBadge
β”‚   └── ui/                    # shadcn components
β”œβ”€β”€ lib/
β”‚   β”œβ”€β”€ design-system.ts       # Design tokens
β”‚   └── utils.ts               # Utilities
β”œβ”€β”€ data/
β”‚   └── mock-data.ts           # Realistic mock data
└── types/
    └── index.ts               # TypeScript definitions

🎯 Design Principles Applied

Visual Hierarchy

  • Clear heading scales (36px β†’ 13px)
  • Consistent spacing system
  • Strategic use of color and contrast

Micro-Interactions

  • Smooth page transitions (Framer Motion)
  • Hover states on cards and buttons
  • Active navigation indicators
  • Progress bar animations

Trustworthy Design

  • Clean, minimal layouts
  • Professional color palette
  • Consistent spacing
  • No clutter or aggressive CTAs

Responsive

  • Mobile-first approach
  • Sidebar collapses on mobile
  • Grid layouts adapt to screen size

🌟 Highlights

What Makes This Special

  1. Premium UI: Looks like a $10k/month SaaS product
  2. Attention to Detail: Consistent spacing, shadows, borders
  3. Smooth Animations: Page loads, card hovers, transitions
  4. Real-world Data: 130 plots across 2 projects with realistic statuses
  5. Enterprise-Ready: Scalable architecture, clean code, TypeScript

Key Differentiators

  • NOT a template β€” custom-designed from scratch
  • Premium aesthetics inspired by Linear, Notion, Vercel
  • Production-ready code quality
  • Can be demoed to clients/investors immediately

πŸ“Έ Screenshots

Dashboard Overview

  • Revenue metrics with gradient accents
  • Project cards with progress bars
  • Clean, spacious layout

Plot Management

  • Color-coded status grid
  • Advanced filtering
  • Real-time stats

Landing Page

  • Modern hero section
  • Feature showcase
  • Location highlights

🚒 Deployment

Vercel (Recommended)

npm run build
vercel deploy

Docker

FROM node:18-alpine
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
RUN npm run build
CMD ["npm", "start"]

πŸ“ Development Notes

Adding New Pages

  1. Create route in src/app/(dashboard)/
  2. Add to Sidebar navigation
  3. Follow design system tokens

Modifying Design System

Edit src/lib/design-system.ts for colors, spacing, typography

Mock Data

Extend src/data/mock-data.ts for additional projects/plots


πŸŽ“ Learning Resources


πŸ“œ License

Built by Webbheads for demonstration purposes.


πŸ™Œ Credits

  • Design Inspiration: Linear, Notion, Vercel, Stripe
  • UI Components: shadcn/ui
  • Framework: Next.js by Vercel

Ready to impress clients and investors? Start the dev server and explore the dashboard!

npm run dev
# Open http://localhost:3000

plot-management

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published