An AI SaaS Platform

Build this project step by step with our detailed tutorial on JavaScript Mastery YouTube. Join the JSM family!

📋 Table of Contents

1. 🤖 Introduction
2. ⚙️ Tech Stack
3. 🔋 Features
4. 🤸 Quick Start
5. 🕸️ Snippets
6. 🔗 Links
7. 🚀 More

🚨 Tutorial

This repository contains the code corresponding to an in-depth tutorial available on our YouTube channel, JavaScript Mastery.

If you prefer visual learning, this is the perfect resource for you. Follow our tutorial to learn how to build projects like these step-by-step in a beginner-friendly manner!

🤖 Introduction

Build an AI image SaaS platform that excels in image processing capabilities, integrates a secure payment infrastructure, offers advanced image search functionalities, and supports multiple AI features, including image restoration, recoloring, object removal, generative filling, and background removal. This project can be a guide for your next AI image tool and a boost to your portfolio.

If you're getting started and need assistance or face any bugs, join our active Discord community with over 27k+ members. It's a place where people help each other out.

⚙️ Tech Stack

• Next.js
• TypeScript
• MongoDB
• Clerk
• Cloudinary
• Stripe
• Shadcn
• TailwindCSS

🔋 Features

👉 Authentication and Authorization: Secure user access with registration, login, and route protection.

👉 Community Image Showcase: Explore user transformations with easy navigation using pagination

👉 Advanced Image Search: Find images by content or objects present inside the image quickly and accurately

👉 Image Restoration: Revive old or damaged images effortlessly

👉 Image Recoloring: Customize images by replacing objects with desired colors easily

👉 Image Generative Fill: Fill in missing areas of images seamlessly

👉 Object Removal: Clean up images by removing unwanted objects with precision

👉 Background Removal: Extract objects from backgrounds with ease

👉 Download Transformed Images: Save and share AI-transformed images conveniently

👉 Transformed Image Details: View details of transformations for each image

👉 Transformation Management: Control over deletion and updates of transformations

👉 Credits System: Earn or purchase credits for image transformations

👉 Profile Page: Access transformed images and credit information personally

👉 Credits Purchase: Securely buy credits via Stripe for uninterrupted use

👉 Responsive UI/UX: A seamless experience across devices with a user-friendly interface

and many more, including code architecture and reusability

🤸 Quick Start

Follow these steps to set up the project locally on your machine.

Prerequisites

Make sure you have the following installed on your machine:

• Git
• Node.js
• npm (Node Package Manager)

Cloning the Repository

git clone https://github.com/adrianhajdin/imaginify.git
cd imaginify

Installation

Install the project dependencies using npm:

npm run dev

Set Up Environment Variables

Create a new file named .env.local in the root of your project and add the following content:

#NEXT
NEXT_PUBLIC_SERVER_URL=

#MONGODB
MONGODB_URL=

#CLERK
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=
CLERK_SECRET_KEY=
WEBHOOK_SECRET=

NEXT_PUBLIC_CLERK_SIGN_IN_URL=/sign-in
NEXT_PUBLIC_CLERK_SIGN_UP_URL=/sign-up
NEXT_PUBLIC_CLERK_AFTER_SIGN_IN_URL=/
NEXT_PUBLIC_CLERK_AFTER_SIGN_UP_URL=/

#CLOUDINARY
NEXT_PUBLIC_CLOUDINARY_CLOUD_NAME=
CLOUDINARY_API_KEY=
CLOUDINARY_API_SECRET=

#STRIPE
STRIPE_SECRET_KEY=
STRIPE_WEBHOOK_SECRET=
NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=

Replace the placeholder values with your actual respective account credentials. You can obtain these credentials by signing up on the Clerk, MongoDB, Cloudinary and Stripe

Running the Project

npm run dev

Open http://localhost:3000 in your browser to view the project.

🕸️ Snippets

InsufficientCreditsModal.tsx

```typescript "use client"; import Image from "next/image"; import { useRouter } from "next/navigation"; import { AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogTitle, } from "@/components/ui/alert-dialog"; export const InsufficientCreditsModal = () => { const router = useRouter(); return (

Insufficient Credits

router.push("/profile")} >

Oops.... Looks like you've run out of free credits! No worries, though - you can keep enjoying our services by grabbing more credits. router.push("/profile")} > No, Cancel router.push("/credits")} > Yes, Proceed ); }; ```

components/shared/Collection.tsx

```typescript "use client"; import Image from "next/image"; import Link from "next/link"; import { useSearchParams, useRouter } from "next/navigation"; import { CldImage } from "next-cloudinary"; import { Pagination, PaginationContent, PaginationNext, PaginationPrevious, } from "@/components/ui/pagination"; import { transformationTypes } from "@/constants"; import { IImage } from "@/lib/database/models/image.model"; import { formUrlQuery } from "@/lib/utils"; import { Button } from "../ui/button"; import { Search } from "./Search"; export const Collection = ({ hasSearch = false, images, totalPages = 1, page, }: { images: IImage[]; totalPages?: number; page: number; hasSearch?: boolean; }) => { const router = useRouter(); const searchParams = useSearchParams(); // PAGINATION HANDLER const onPageChange = (action: string) => { const pageValue = action === "next" ? Number(page) + 1 : Number(page) - 1; const newUrl = formUrlQuery({ searchParams: searchParams.toString(), key: "page", value: pageValue, }); router.push(newUrl, { scroll: false }); }; return ( <>

Recent Edits

{hasSearch && }

{images.length > 0 ? (

{images.map((image) => ( ))}

) : (

Empty List

)} {totalPages > 1 && ( onPageChange("prev")} >

{page} / {totalPages}

onPageChange("next")} disabled={Number(page) >= totalPages} > )} ); }; const Card = ({ image }: { image: IImage }) => { return (

{image.title}

); }; ```

components/shared/Search.tsx

```typescript "use client"; import Image from "next/image"; import { useRouter, useSearchParams } from "next/navigation"; import { useEffect, useState } from "react"; import { Input } from "@/components/ui/input"; import { formUrlQuery, removeKeysFromQuery } from "@/lib/utils"; export const Search = () => { const router = useRouter(); const searchParams = useSearchParams(); const [query, setQuery] = useState(""); useEffect(() => { const delayDebounceFn = setTimeout(() => { if (query) { const newUrl = formUrlQuery({ searchParams: searchParams.toString(), key: "query", value: query, }); router.push(newUrl, { scroll: false }); } else { const newUrl = removeKeysFromQuery({ searchParams: searchParams.toString(), keysToRemove: ["query"], }); router.push(newUrl, { scroll: false }); } }, 300); return () => clearTimeout(delayDebounceFn); }, [router, searchParams, query]); return (

setQuery(e.target.value)} />

); }; ```

transformations/[id]/page.tsx

```typescript import { auth } from "@clerk/nextjs"; import Image from "next/image"; import Link from "next/link"; import Header from "@/components/shared/Header"; import TransformedImage from "@/components/shared/TransformedImage"; import { Button } from "@/components/ui/button"; import { getImageById } from "@/lib/actions/image.actions"; import { getImageSize } from "@/lib/utils"; import { DeleteConfirmation } from "@/components/shared/DeleteConfirmation"; const ImageDetails = async ({ params: { id } }: SearchParamProps) => { const { userId } = auth(); const image = await getImageById(id); return ( <>

Transformation:

{image.transformationType}

{image.prompt && ( <>

●

Prompt:

{image.prompt}

)} {image.color && ( <>

●

Color:

{image.color}

)} {image.aspectRatio && ( <>

●

Aspect Ratio:

{image.aspectRatio}

)}

{/* MEDIA UPLOADER */}

Original

{/* TRANSFORMED IMAGE */}

{userId === image.author.clerkId && (

Update Image

)}

); }; export default ImageDetails; ```

profile/page.tsx

```typescript import { auth } from "@clerk/nextjs"; import Image from "next/image"; import { redirect } from "next/navigation"; import { Collection } from "@/components/shared/Collection"; import Header from "@/components/shared/Header"; import { getUserImages } from "@/lib/actions/image.actions"; import { getUserById } from "@/lib/actions/user.actions"; const Profile = async ({ searchParams }: SearchParamProps) => { const page = Number(searchParams?.page) || 1; const { userId } = auth(); if (!userId) redirect("/sign-in"); const user = await getUserById(userId); const images = await getUserImages({ page, userId: user._id }); return ( <>

CREDITS AVAILABLE

{user.creditBalance}

IMAGE MANIPULATION DONE

{images?.data.length}

); }; export default Profile; ```

🔗 Links

Public Assets used in the project can be found here

🚀 More

Advance your skills with Next.js 14 Pro Course

Enjoyed creating this project? Dive deeper into our PRO courses for a richer learning adventure. They're packed with detailed explanations, cool features, and exercises to boost your skills. Give it a go!

Accelerate your professional journey with the Expert Training program

And if you're hungry for more than just a course and want to understand how we learn and tackle tech challenges, hop into our personalized masterclass. We cover best practices, different web skills, and offer mentorship to boost your confidence. Let's learn and grow together!

#