Skip to content

Latest commit

 

History

History
57 lines (38 loc) · 4.4 KB

PRODUCT.md

File metadata and controls

57 lines (38 loc) · 4.4 KB

Product

Platform

web

Users

  • Renters looking for a long-term flat or house in a Spanish city. They browse and compare listings, mostly on a phone, and want the real monthly price, size and location up front. To ask about a place they send the owner an enquiry; they need an account only to save listings.
  • Owners letting their own flat or house without an agency. They sign up, post a listing with photos, edit or delete it, and read the enquiries it receives. They post from a laptop or a phone.

Product Purpose

Doorplate is a listings site for long-term rentals posted directly by their owners: no agency in between and no agency fees. A renter finds a place, sees who owns it, and writes to that person. Success means a renter can tell from the listing whether a place fits (price, size, rooms, area) and reaches the owner in one step, and an owner can publish a clear listing in a few minutes.

Positioning

Every listing belongs to a named owner, and every enquiry goes to that owner. Agencies don't post. Deliberately narrow: long-term rentals only; no sales, no holiday lets, no room shares.

Operating Context

  • A listing has: title, summary, description, monthly rent (EUR), city and area, property type (flat or house), bedrooms, bathrooms, floor area (m²), and an ordered set of photos. It shows the owner's name and the date it was listed.
  • Renters filter by city, price range, bedrooms and size, and sort by newest or price.
  • Enquiry: renter's name, email, message and preferred move-in date, stored against the listing. The owner reads enquiries per listing in their account.
  • Saved listings: signed-in users can save a listing and see their saved list. Share uses the native share sheet on phones and copies the link on desktop.
  • Locale: English UI, Spain, EUR, m². Demo listings are in Spanish cities (Valencia, Madrid, etc.).

Capabilities and Constraints

  • Next.js 16 App Router (Server Components + Server Actions), React 19, JavaScript (no TypeScript), Tailwind CSS 3 with shadcn/ui on Radix, SQLite via better-sqlite3, Drizzle ORM with SQL migrations, Auth.js v5 Credentials (bcrypt, JWT cookie), zod, sonner.
  • Photo uploads are written to public/uploads/ on the local disk; together with SQLite this means one server with a disk, not serverless hosting. A live deployment is planned later, separately.
  • Existing behaviour to keep: sign up and log in, create, edit and delete listings with multiple photos, a user profile with that user's listings, route protection for posting and editing.
  • New in this revamp: the listing fields above (schema migration and new seed), filters, enquiries, saved listings, share.

Brand Commitments

  • Name: Doorplate (from 2026-11-16; previously "Homely"). Never reference, link or imitate homely.com.au, an unrelated Australian property portal.
  • The landing page speaks to renters and owners as a real product; it does not present itself as a demo.
  • Trust over novelty, the same bar as Maria's Quote & Nod: conventional, professional, "boring but trustworthy". Reference: Ghost's official themes (white ground, near-black text, one brand colour mostly on the main action, standard navigation, real photographs, plain copy). It must not feel AI-made.
  • The previous Homely look is rejected and must not return: pill badge with a sparkle icon above the headline ("Fresh listings every day"), large serif headline with the last words in the accent colour, teal pill buttons, soft shadowed cards, AI-looking interior renders.
  • Doorplate must look clearly distinct from Quote & Nod (its sibling portfolio piece, white ground and deep green).
  • Free fonts only.

Evidence on Hand

  • Codebase and its demo flow; the seed script creates a demo owner and sample listings.
  • Current seed photos are not usable: one carries a "HouseBeautiful" watermark and several look AI-generated. Demo listings need real photographs under a free licence, with each photo's source recorded.
  • No users, testimonials, listing counts, reviews or press exist. None may be invented (the old "thousands of curated listings" line goes).

Product Principles

  1. The owner is a person: every listing shows who lets it, and the renter writes to them directly.
  2. The facts first: price per month, rooms, size and area are visible before any description.
  3. Nothing fake: every button works, and every number on the site is real data.
  4. Narrow on purpose: long-term rentals only.