Explore the live demonstration of the project: nextjs14-zoom
Yoom is a video conferencing application built with Next.js, Tailwind CSS, Clerk, and GetStream. It allows users to create and join video meetings, schedule meetings, and view upcoming and previous meetings. The application is built with a modern design and user-friendly interface.
Folder Structure
nextjs14-zoom/
βββ app/
β βββ (auth)/
β β βββ sign-in/
β β β βββ [[...sign-in]]/
β β β βββ page.tsx
β β βββ sign-up/
β β βββ [[...sign-up]]/
β β βββ page.tsx
β βββ (root)/
β β βββ (home)/
β β β βββ layout.tsx
β β β βββ page.tsx
β β β βββ personal-room/
β β β β βββ page.tsx
β β β βββ previous/
β β β β βββ page.tsx
β β β βββ recordings/
β β β β βββ page.tsx
β β β βββ upcoming/
β β β βββ page.tsx
β β βββ layout.tsx
β β βββ meeting/
β β βββ [id]/
β β βββ page.tsx
β βββ favicon.ico
β βββ globals.css
β βββ layout.tsx
βββ components/
β βββ home-card.tsx
β βββ layout/
β β βββ mobile-nav.tsx
β β βββ navbar.tsx
β β βββ sidebar.tsx
β βββ loader.tsx
β βββ meeting-modal.tsx
β βββ meeting-room.tsx
β βββ meeting-setup.tsx
β βββ meeting-type-list.tsx
β βββ ui/
β βββ button.tsx
β βββ dialog.tsx
β βββ sheet.tsx
β βββ toast.tsx
β βββ toaster.tsx
β βββ use-toast.ts
βββ constants/
β βββ index.ts
βββ hooks/
β βββ use-get-call-by-id.ts
βββ lib/
β βββ utils.ts
βββ actions/
β βββ stream.actions.ts
βββ providers/
β βββ stream-client-provider.tsx
βββ public/
β βββ icons/[[...]].svg
β βββ images/[[...]].{jpeg,png}
β βββ next.svg
β βββ vercel.svg
βββ .env.local
βββ .eslintignore
βββ .eslintrc.json
βββ .gitignore
βββ .prettierignore
βββ .prettierrc
βββ components.json
βββ middleware.ts
βββ next-env.d.ts
βββ next.config.mjs
βββ package-lock.json
βββ package.json
βββ postcss.config.mjs
βββ README.md
βββ tailwind.config.ts
βββ tsconfig.json
Table of Contents
Yoom is built using the following technologies:
- TypeScript: TypeScript is a typed superset of JavaScript that compiles to plain JavaScript.
- Next.js: Next.js is a React framework for building server-side rendered and statically generated web applications.
- Tailwind CSS: Tailwind CSS is a utility-first CSS framework for rapidly building custom user interfaces.
- ESLint: ESLint is a static code analysis tool for identifying problematic patterns found in JavaScript code.
- Prettier: Prettier is an opinionated code formatter.
- Clerk: Clerk is a developer-first authentication API that handles all the logic for user sign up, sign in, and more.
- Shadcn-UI: Shadcn UI is a React UI library that helps developers rapidly build modern web applications.
- React Datepicker: React Datepicker is a simple and reusable datepicker component for React.
- Vercel: Vercel is a cloud platform for frontend developers, providing the frameworks, workflows, and infrastructure to build a faster, more personalized Web.
To get this project up and running in your development environment, follow these step-by-step instructions.
In order to install and run this project locally, you would need to have the following installed on your local machine.
Step 0:
Important
- the application uses Clerk for Authentication and User Management, therefore, you need to create
Clerk account here and sets the
CLERK_PUBLISHABLE_KEY
andCLERK_SECRET_KEY
environment variables in.env
file. Also, the different URLs for the Clerk sign-in, sign-up, after sign-in and after sign-up pages. - the application uses GetStream for Video & Audio Calls, therefore, you need to create GetStream
account here and sets the
STREAM_APP_ID
,STREAM_API_KEY
, andSTREAM_SECRET_KEY
environment variables in.env
file.
Step 1:
Download or clone this repo by using the link below:
git clone https://github.com/ladunjexa/nextjs14-zoom.git
Step 2:
Execute the following command in the root directory of the downloaded repo in order to install dependencies:
npm install
Step 3:
Execute the following command in order to run the development server locally:
npm run dev
Step 4:
Open http://localhost:3000 with your browser to see the result.
All scripts are defined in the package.json
file. Here is a list of all scripts:
Script | Action |
---|---|
npm install |
Installs dependencies |
npm run dev |
Starts local dev server at localhost:3000 |
npm run build |
Build your production site to ./dist/ |
npm run start |
Start your production site locally |
npm run lint |
Run ESLint |
Environment variables[^10] can be used for configuration. They must be set before running the app.
Environment variables are variables that are set in the operating system or shell, typically used to configure programs.
Yoom uses Clerk and GetStream as external services. You need to create an account on each of these services and get the required credentials to run the app.
Create a .env
file in the root directory of the project and add the following environment
variables:
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=<CLERK_PUBLISHABLE_KEY>
CLERK_SECRET_KEY=<CLERK_SECRET_KEY>
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=/
NEXT_PUBLIC_STREAM_APP_ID=<STREAM_APP_ID>
NEXT_PUBLIC_STREAM_API_KEY=<STREAM_API_KEY>
STREAM_SECRET_KEY=<STREAM_SECRET_KEY>
NEXT_PUBLIC_BASE_URL=<BASE_URL>
You can create an optimized production build with the following command:
npm run build
The easiest way to deploy this Next.js app is to use the Vercel Platform.
You can also deploy this Next.js app with Netlify.
Check out Next.js deployment documentation for more details.
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
To fix a bug or enhance an existing module, follow these steps:
- Fork the repo
- Create a new branch (
git checkout -b improve-feature
) - Make the appropriate changes in the files
- Commit your changes (
git commit -am 'Improve feature'
) - Push to the branch (
git push origin improve-feature
) - Create a Pull Request π
If you find a bug (failure of a module to execute its intended function), kindly open an issue here by including the issue with a title and clear description.
If you'd like to request a new function, feel free to do so by opening an issue here. Please include sample queries and their corresponding results.
I'd like to express my gratitude to the following people who helped me with this project and made it possible:
Yoom is open source software licensed as MIT and is free to use β See LICENSE for more details.