Wild Oasis

Next.js 14 application with App Router and Server Actions allowing users to book cabins at the Wild Oasis hotel.
Users can navigate different cabins, sign up with Google and create an account.
Logged-in users can securely book cabins using Stripe for payment.
Users can also get a refund if the conditions are met.
Responsive-design, Tailwind.css.
Optimistic UI.

Table of Contents

• Prerequisites
• Installation
• Running the Development Server
• Building for Production
• Running the Production Server
• Technologies Used
• Stripe Webhook
• Live Demo 🚀

Prerequisites

• Google Cloud Account: Required to set up Next-auth Google Provider
• Supabase Account: Required for database functionalities.
• Stripe Account: Required for payment processing functionalities.

Installation

Installation

1. Clone the repository:

git clone git@github.com:SiegfriedBz/next-wild-oasis.git
cd next-wild-oasis

2. Install dependencies:

npm install

3. Set up environment variables:

Create a .env file in the root directory and add the following environment variables

NEXT_PUBLIC_URL=
CORS_ALLOWED_ORIGIN=

# opengraph image
NEXT_PUBLIC_OG_IMAGE_URL="your-opengrap-1200x600-image"

# Supabase
SUPABASE_URL=
SUPABASE_API_KEY=

# Next Auth & Google Provider
NEXTAUTH_URL=
NEXTAUTH_SECRET=
GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=

# Stripe keys
NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=
STRIPE_SECRET_KEY=
STRIPE_WEBHOOK_SECRET=

Running the Development Server

To start the development server, run:

npm run dev

Building for Production

To build the project for production, run:

npm run build

Running the Production Server

After building the project, you can start the production server with:

npm start

Technologies Used

Frontend:

• Framework: React, Next.js 14 (App Router)
• React Hook Form, Zod (for client-side validation)
• React Select (for forms customization)
• Styling: Tailwind CSS, responsive design

Backend:

• DB: SupaBase
• Authentication: NextAuth.js with Google Provider

Payment Processing & Payment Refund:

• Stripe

Stripe Webhook

Note - when a user initiates a payment, a non-confirmed booking is created in the database. Configure the Stripe webhook to listen for checkout.session.completed events. After checkout, the webhook will update the corresponding booking:

• Set is_paid to true.
• Set stripe_intent_id to the value retrieved from the Stripe event. The stripe_intent_id will allow Stripe to retrieve a payment and to proceed to refund on user's request.

Live Demo

Visit the live demo of The Wild Oasis deployed on Vercel.