Property Pulse

A web application to help you find your next rental property.

This is the main project from my Next 14 From Scratch Course

This is the old version of the app that uses API routes for properties, messaging, etc. The current/latest version of the courses uses server actions. The updated code can be found here as well as in the refactor branch.

Important notes

If you are following along with the course and running into issues, then please take the time to read the README in the bugfix branch as this solves many common problems.

There is also a refactor branch where the code has been heavily refactored to stay true to NextJS recommended best practices by using querying the database directly from our server components for data fetching, and performing updates and adding data using server actions.
The refactor also makes deployment a fair bit smoother.
The course is currently being re recorded for a re release using the code in the refactor branch.

The _theme_files folder contains the pure HTML files with Tailwind classes.

Features

Here are some of the current features that Property Pulse has:

• [x] User authentication with Google & Next Auth
• [x] User authorization
• [x] Route protection
• [x] User profile with user listings
• [x] Property Listing CRUD
• [x] Property image upload (Multiple)
• [x] Property search
• [x] Internal messages with 'unread' notifications
• [x] Photoswipe image gallery
• [x] Mapbox maps
• [x] Toast notifications
• [x] Property bookmarking / saved properties
• [x] Property sharing to social media
• [x] Loading spinners
• [x] Responsive design (Tailwind)
• [x] Custom 404 page

Property Pulse uses the following technologies:

• Next.js
• React
• Tailwind CSS
• MongoDB
• Mongoose
• NextAuth.js
• React Icons
• Photoswipe
• Cloudinary
• Mapbox
• React Map GL
• React Geocode
• React Spinners
• React Toastify
• React Share

Getting Started

Prerequisites

• Node.js version 18 or higher
• MongoDB Atlas account and a cluster. Sign up and create a cluster at MongoDB
• Cloudinary account. Sign up at Cloudinary
• Google console account. Sign up at Google Cloud
• Mapbox account. Sign up at Mapbox

.env File

Rename the env.example file to .env and fill in the following environment variables:

• Get your MongoDB connection string from your MongoDB Atlas cluster and add it to MONGODB_URI.
• Get your Google client ID and secret from your Google console account and add them to GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET.
• Add a secret to NEXTAUTH_SECRET. You can generate with the following command:

  openssl rand -base64 32

• Get your Cloudinary cloud name, API key, and API secret from your Cloudinary account and add them to CLOUDINARY_CLOUD_NAME, CLOUDINARY_API_KEY, and CLOUDINARY_API_SECRET.
• Get your Mapbox token from your Mapbox account and add it to NEXT_PUBLIC_MAPBOX_TOKEN.
• Get your Google Geocoding API key from your Google console account and add it to NEXT_PUBLIC_GOOGLE_GEOCODING_API_KEY.

Install Dependencies

npm install

Run the Development Server

npm run dev

Open http://localhost:3000 with your browser to see the result.

License

This project is licensed under the MIT License - see the LICENSE.md file for details