To

Project Description for Vercel v0

Platform Name:

Adspacity Descriiption : Adspacity is a dynamic marketplace connecting adspace owners and advertisers. It allows billboard and adspace owners to list their spaces with detailed information, including location, images, pricing, and key advantages, while integrating Google Maps and Street View for enhanced visibility. Advertisers can easily search, filter, and explore available adspaces on an interactive map, rent them directly, or place competitive bids. With secure payment processing through LemonSqueezy and real-time data management powered by Pocketbase, Adspacity streamlines the process of finding and renting prime advertising locations.

User Roles:

1. Adspace Owners (Sellers):

   • Post available advertising spaces with detailed information.
   • Manage existing listings, view engagement statistics, and update content as needed.

2. Adspace Renters (Buyers):

   • Search and filter adspaces by location, type, and price.
   • View listings in both list and map formats.
   • Rent or place bids for specific adspaces.

---

Core Features:

1. Adspace Listing Creation (For Owners)

• Form-based UI for submitting the following:
  • Adspace location with Google Maps and Street View integration.
  • Image uploads (multiple images supported).
  • Adspace details, including:
    • Description
    • Key location highlights and advantages
    • Type of adspace (e.g., static billboard, digital signage)
    • Pricing details (rental rates and bidding starting prices)
    • Contact information
• Payment integration using LemonSqueezy:
  • Owners must make a payment before posting a listing.
  • Payment confirmation triggers listing publication.

2. Adspace Browsing and Filtering (For Renters)

• Search and Filter Options:

  • Location-based filtering
  • Price range, type of adspace, availability status
  • Keywords for targeted searches

• Map View:

  • Interactive Google Maps integration displaying adspace markers.
  • Markers provide a quick summary of the listing and allow renters to click for detailed views.

3. Adspace Interaction

• Rent Directly:
  • Renters can secure an adspace by confirming availability and payment terms.
• Bid on Adspace:
  • Renters can place bids for specific adspaces within a defined bidding period.
  • Bid history and current highest bid are displayed for transparency.

4. Payment Integration

• LemonSqueezy Integration:
  • Handle secure payments for both adspace posting and direct rentals.
  • Webhooks to track payment success and update listing or rental statuses automatically.

5. Authentication and User Management

• User Roles:
  • Different views and permissions for Adspace Owners and Renters.
• Secure Signup/Login:
  • Support for email-based registration and login, password reset functionality.

6. Dashboard Features

• For Owners:

  • Manage listings, view rental/bid status, and payment history.

• For Renters:

  • View bid history, rental agreements, and notifications for bid status or successful rentals.

---

Backend Functionalities (Pocketbase and NextJS Serveractions)

1. Adspace Listings Management:

   • Store listing data (location, description, pricing, images).
   • Maintain relationships between listings, owners, and bids.

2. User Management:

   • Role-based user system for owners and renters.
   • Secure user authentication and data storage.

3. Real-time Data:

   • Sync updates for bid status, rentals, and payments using Pocketbase real-time features.

---

Frontend and UI/UX Requirements

• Modern and Intuitive UI:

  • Professional design using Shadcn components for consistent styling.

• Mobile Responsiveness:

  • Fully responsive design to accommodate desktop, tablet, and mobile users.

• Navigation:

  • Clear navigation with distinct pages for home, search results, dashboard, and adspace details.

---

Third-Party involvements

1. Google Maps and Street View:

   • Adspace owners when submitting a new adspace when posting new adspace will paste in google maps link and the website will give both google maps link and streetview link to the renters

2. LemonSqueezy API:

   • Handle payments for adspace postings and rentals securely.

---

implement complete frontend and backend and give it in working stage