Petno Norway

A Cursor IDE–powered SaaS directory connecting ethical dog breeders with prospective puppy owners across Norway.

---

📋 Table of Contents

• Project Overview
• Built With
• Getting Started
  • Prerequisites
  • Installation
  • Environment Variables
• Working in Cursor IDE
• Project Structure
• Available Scripts
• Contributing
• License

---

Project Overview

Petno Norway is a modern, serverless directory and marketplace built with Next.js, Tailwind CSS, and Supabase. Using Cursor IDE’s AI‑powered tooling and this README as context, you can quickly scaffold features, navigate user flows, and maintain consistency across the codebase.

Core capabilities include:

• Search & Filtering
  Filter breeder profiles by breed, region, and availability.
• Breeder Onboarding
  Profile management, litter scheduling, and contract templates.
• In‑App Messaging & Digital Contracts
  Secure messaging and e‑signature workflows.
• Premium Boosts
  Paid promotions via Stripe integration.

---

Built With

• Next.js – React framework for server‑rendered pages
• React – Component‑based UI library
• Tailwind CSS – Utility‑first styling
• Supabase – Postgres database & authentication
• AuthJS (NextAuth) – Authentication
• Resend – Email link delivery
• Stripe – Billing & payments
• 21st.dev Magic MCP – UI block components
• Cursor IDE – AI‑assisted code generation & navigation

---

Getting Started

Prerequisites

• Node.js v18.x or higher
• npm or Yarn
• Cursor IDE account (workspace configured)
• GitHub account for repository hosting

Installation

1. Clone the repository

   git clone git@github.com:your-username/petno.git
   cd puppyfinder-norway