deepsingh132/aionair repository overview

⁠OnAir.ai Podcast Platform

⁠📋 Table of Contents⁠

1. 🤖 Introduction⁠
2. ⚙️ Tech Stack⁠
3. 🔋 Features⁠
4. 📸 Screenshots⁠
5. 🤸 Getting Started⁠
6. 🐳 Docker Instructions⁠
7. 📄 License⁠
8. 📞 Contact⁠

⁠🤖 Introduction⁠

A cutting-edge AI SaaS platform that enables users to create, discover, and enjoy podcasts with advanced features like text-to-audio conversion with multi-voice AI, podcast thumbnail Image generation and seamless playback. The platform is built using Next.js, TypeScript, Convex, OpenAI, Clerk, ShadCN, and Tailwind CSS. It offers a modern home page, podcast discovery page, search functionality, podcast creation page, profile page, podcast details page, and a responsive design for a seamless user experience.

⁠⚙️ Tech Stack⁠

• Next.js
• TypeScript
• Convex
• OpenAI
• Stripe (for payments)
• Clerk
• ShadCN
• Tailwind CSS
• Zod (for validation)

⁠🔋 Features⁠

👉 Advanced Authentication: Offers secure and dependable user login and registration functionalities.

👉 Contemporary Home Page: Highlights trending podcasts with a persistent player for uninterrupted listening.

👉 Podcast Discovery Page: A dedicated section for users to explore a wide range of new and popular podcasts.

👉 Comprehensive Search Functionality: Empowers users to effortlessly find podcasts using various filters and criteria.

👉 Podcast Creation Page: Facilitates podcast creation with text-to-speech conversion, AI-generated images, and preview options.

👉 Multi-Voice AI Capability: Provides multiple AI-generated voice options for creating dynamic and engaging podcasts.

👉 User Profile Page: Allows users to view and manage their created podcasts, including options to delete them.

👉 Detailed Podcast Page: Presents in-depth information about each podcast, including creator details, listener statistics, and transcripts.

👉 Enhanced Podcast Player: Includes features like rewind/fast forward controls and mute/unmute functionality for an optimal listening experience.

👉 Responsive Design: Ensures the platform looks great and works seamlessly on all devices and screen sizes.

and many more, including code architecture and reusability

⁠📸 Screenshots⁠

Homepage
Discover Page
Create Podcast Page
Podcast Details Page
Profile Page
Plans Page
Payment / Stripe Checkout Page
Usage Page

⁠🤸 Getting Started⁠

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/deepsingh132/aionair.git
cd aionair

Installation

Install the project dependencies using npm:

npm install

Set Up Environment Variables

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

CONVEX_DEPLOYMENT=
NEXT_PUBLIC_CONVEX_URL=
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=
CLERK_SECRET_KEY=
NEXT_PUBLIC_CLERK_SIGN_IN_URL='/sign-in'
NEXT_PUBLIC_CLERK_SIGN_UP_URL='/sign-up'
OPENAI_API_KEY=
NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=
STRIPE_SECRET_KEY=

Replace the placeholder values with your actual Convex & Clerk credentials. You can obtain these credentials by signing up on the Convex⁠, Clerk⁠, OpenAI⁠ and Stripe⁠ websites.

Running the Project

npm run dev

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

Testing Stripe Payments

To test the Stripe payments/subscriptions functionality, you can use the following test card details:

• Card Number: 4242 4242 4242 4242
• Expiry Date: Any future date
• CVC/CVV: Any 3-digit number
• Cardholder Name: Any name
• Address: Any address (e.g., 123 Main Street)
• ZIP Code: Any 5-digit number

You can also use the Stripe Test Cards⁠ for more test card details.

⁠🐳 Docker Instructions⁠

You can run this project using Docker with the latest image from Docker Hub. Make sure you have Docker installed and running on your machine. Follow these steps:

1. Pull the latest image from Docker Hub.

   docker pull deepsingh132/aionair:latest
   

   Copy

2. Run the Docker image with the following command:

   docker run --env-file .YOURENVFILE -p 3000:3000 deepsingh132/aionair:latest
   

   Copy

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

⁠📚 License⁠

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

⁠📞 Contact⁠

If you have any queries or feedback, please feel free to reach out to me at my email⁠ or connect with me on LinkedIn⁠.