Build a Directory Site

Build a public directory called [DIRECTORY NAME] for people looking for [TYPE OF BUSINESSES, SERVICES, PLACES OR RESOURCES] in [AREA OR NICHE].

Create a home page that explains what the directory includes, who it helps and how listings are chosen. Add a main directory page with clear listing cards and a reusable page for one full listing. Also add an about page explaining [WHY THIS DIRECTORY EXISTS] and a contact page using [CONTACT EMAIL].

Save listings as editable information so one consistent layout can display all of them. Each listing needs a public name, short summary, full description, controlled category, service or topic tags, location or service area when relevant, public contact details, public website, opening or availability information when relevant, accessibility information when known, real image, last checked date and status. Status is draft, published, paused or closed. Only published listings appear to visitors.

On each listing card show [CARD FIELDS, e.g. name, category, area and short summary]. On the full listing page show [DETAIL PAGE FIELDS] in a clear order, with a contact action labelled [CONTACT ACTION]. Do not invent ratings, reviews, prices, certifications, opening hours, addresses or availability.

Add five example listings clearly labelled as examples for me to replace. Use labelled placeholders saying [REAL LISTING IMAGE NEEDED]. Do not use stock photos and do not generate images of businesses, places, staff, customers or results from scratch. Editing my own real photos is fine; only invented or generated scenes are the problem.

Do not add public accounts, listing submission, claim buttons, payments, featured placement or sponsor advertising in this step. Do not display search or filter controls that do nothing.

Design the site to feel [THREE BRAND ADJECTIVES] using [COLORS]. Make cards easy to compare without looking identical to a generic template. Make the directory and listing pages comfortable to read and tap on a phone.

When finished, tell me where I edit the example listing information and which fields still need real content.

Add working search, filters and browsing to the existing directory.

Search across [FIELDS SEARCH SHOULD USE, e.g. name, summary, category, tags and area]. Match normal differences in capital letters and extra spaces. Do not claim a result matches a word that is not present in its approved public information.

Add these controlled filters: [FILTERS VISITORS ACTUALLY NEED]. Let people combine filters, see which filters are active and clear one or all. Show the number of matching listings. Keep filter choices consistent with the saved category and tag lists rather than creating new spellings.

Use [RESULT ORDER, e.g. best match, alphabetical or most recently verified] as the default order and explain it in plain language. Do not secretly rank paid or owner-favoured listings as the best match. If featured placement is added later, it must be visibly labelled and handled separately.

For location, use [AREA FILTER / DISTANCE SEARCH / NO LOCATION FILTER]. If using distance, ask permission before using the visitor's location, provide a typed location alternative and calculate distance only from accurate listing locations. Never invent map points. If exact locations are sensitive, show the approved public service area instead.

When there are many matches, load them in manageable groups without losing the current search and filters. When nothing matches, say so calmly, keep the entered search visible and offer a clear way to remove filters or suggest a listing. Do not replace no results with unrelated listings that look like matches.

Keep draft, paused and closed listings out of all public search results. A direct saved address for a non-public listing must not reveal its private content.

Test [THREE REAL SEARCHES], one combined filter, one search with no matches and one search containing a spelling or spacing variation. Tell me which listings appeared and why.

Add listing owner accounts, new listing submissions, listing claims and a private moderation workflow.

Use the platform's built-in account system for sign-up, login, logout and forgotten-password reset. There are two roles. I am the site owner. A listing owner can see and manage only listings whose ownership I have approved. A listing owner must never make themselves the site owner, approve a claim, publish a listing, mark it featured or reach another owner's private information.

Add a submit a listing form for [REQUIRED SUBMISSION FIELDS]. Explain which information will be public and require the submitter to confirm they have the right to provide the text, contact details and images. Save every new submission as pending review. It must not appear in the public directory or search until I approve it.

Add a claim this listing action to unclaimed listing pages. The applicant must sign in, identify the listing, provide [CLAIM PROOF, e.g. an email at the listing's public domain or a document I can review] and explain their connection. Keep proof private. A request does not change ownership or public content until I approve it.

Detect likely duplicates using the listing name, website, public contact details and location. Warn the submitter and show me the possible match instead of silently publishing a second listing.

Add a private moderation area for me with separate queues for new listings, claims and edits. I can compare submitted information with the current public version, approve it, reject it with a reason or ask for changes. For an edit to an already published listing, keep the approved public version visible while the proposed changes wait for review.

When I approve a claim, connect only that account to that listing. The listing owner can then propose edits and upload real images for their own listing. Their edits return to moderation and do not replace the approved public version automatically.

Send clear emails for submission received, approved, rejected and changes requested using [OWNER NOTIFICATION EMAIL]. Do not promise approval or a review time I have not set.

Test the full flow with one plain test account and one site-owner account. Include a direct-address test showing the plain account cannot open the moderation area or another owner's listing controls.

Add this revenue model to the directory: [ONE-TIME PAID LISTING / RECURRING LISTING SUBSCRIPTION / FEATURED PLACEMENT / SPONSOR ADVERTISING]. Build only this model for now.

Explain the offer on a public page using [PRICE] [CURRENCY CODE], [BILLING PERIOD OR PLACEMENT LENGTH] and these exact benefits: [WHAT THE BUYER RECEIVES]. State plainly what payment does not guarantee. Approval, accuracy checks and the right to remain listed are still controlled by the moderation policy.

Connect [PAYMENT PROVIDER, e.g. Stripe] in test mode. Send payment details to the provider's secure checkout and never collect or store card details on this site. Calculate the amount from the protected offer information, not from the customer's browser. Mark payment successful only when the provider sends trusted confirmation, not when the buyer reaches a return page.

Do not ask for payment until the listing, claim or advertising material has passed moderation. For a one-time paid listing or recurring listing subscription, let the approved owner pay and apply [WHAT HAPPENS WHEN PAID]. For featured placement, start and end the feature on the paid dates, label it Featured and return it to normal placement when time ends. For sponsor advertising, require approved wording, destination and real owner-supplied imagery, label it Sponsored and stop it on the purchased end date.

A payment must never publish a rejected listing, approve a claim, erase a moderation flag or let a listing owner set their own featured state. Within normal results, preserve the search order from step 2. Put paid placement in a clearly labelled position so visitors can distinguish it from relevance.

Send the buyer a payment confirmation with what they bought, the listing or placement it applies to, the start and end or renewal terms, and how to manage or cancel when relevant. Send me an owner alert. Add payment state and dates to the private owner area without exposing payment secrets.

Define what happens when payment is cancelled, refunded, fails or expires using [YOUR EXPIRY OR GRACE-PERIOD POLICY]. Do not delete the listing or its history. Apply the correct free, unfeatured, paused or expired state after the stated period.

Guide me through one successful test payment, one cancelled checkout, one failed payment and one expiry or cancellation test.

Complete the listing-owner area and my site-owner operations without weakening moderation, ownership or payment rules.

For a listing owner, show only their approved listings, current public status, proposed edits, moderation messages and paid offer status. Let them update their account contact details, propose listing changes, replace placeholders with real images they have the right to use, and manage or cancel recurring billing through the payment provider when relevant. A proposed edit must still wait for my approval while the last approved public version remains visible.

Give each listing owner a simple activity summary using [OWNER METRICS, e.g. listing views and contact-button clicks]. Explain exactly what each number means. Do not invent visitors, leads, ratings or revenue, and do not identify individual visitors.

For me as the site owner, add one private dashboard with pending submissions, claims and edits, likely duplicates, reports from visitors, listings not checked since [REVIEW AGE], payments needing attention and placements ending soon. Let me filter each queue and open the evidence and history needed for a decision.

Add a public report this listing action for inaccurate, closed, duplicate or inappropriate information. Ask for a reason and contact email, limit repeated automated reports and keep the reporter private. A report must enter my review queue rather than automatically deleting a listing.

Add reminder emails for [OWNER REMINDERS, e.g. update your listing, changes requested, payment ending soon]. Include an unsubscribe route for non-essential reminders. Keep payment receipts and important account messages separate from promotions.

Let me pause a listing, remove featured status, transfer approved ownership and record a private reason. Never erase the listing history when I do this. Restrict all moderation, payment and ownership tools to me, and restrict each listing owner's controls to their own approved listings.

Run the public search, submission, claim, moderation, payment and expiry tests again after these changes. Report any behavior that changed.