next.js

Normal

large_img_8063-min-1.jpg

medium_img_8063-min-1.jpg

small_img_8063-min-1.jpg

thumbnail_img_8063-min-1.jpg

img_8063-min-1.jpg

github-brands.svg

GitHub Yohann

5a22d420c9a5a7-416105621512231968826.png

LinkedIn Yohann

Yohann Martzolff

Tutorials

Next.js

Typescript

React

There’s no doubt that Next.js is a leading solution for creating a full-stack web application. Some of the biggest and finest companies around the world are using this React framework such as Twitch, Nike, and Notion.

On October 2022, Vercel released one of its biggest updates in a brand new version: Next.js 13. This new release ships React 18 with it and some big new features. 

*Read the full [Next.js 13](https://nextjs.org/blog/next-13) / [React 18](https://reactjs.org/blog/2022/03/29/react-v18.html) release notes to learn more.*

Let’s see how we can manage videos in a Next.js 13 and React 18 web application with [api.video](http://api.video) 🧘🏽‍♂️

## Create a Next.js 13 application 🚀

If you already have a Next.js project with a version under 13, you can upgrade it to v13 by [following this guide](https://nextjs.org/docs/upgrading). To keep this article simple, we will create a new application.

1. Run one of the following commands in a new terminal and follow the command prompts

We will name our brand new application videos_app. We will use TypeScript, ESLint (not mandatory), the src/ directory, and the app/ directory (since there is a new V13 feature available). 
Don’t configure any alias yet.

large_screenshot-2023-02-07-at-16-30-34.png

medium_screenshot-2023-02-07-at-16-30-34.png

small_screenshot-2023-02-07-at-16-30-34.png

thumbnail_screenshot-2023-02-07-at-16-30-34.png

screenshot-2023-02-07-at-16-30-34.png

3. Check it out on [`http://localhost:3000`](http://localhost:3000/) and edit `src/app/page.tsx` to see the updated result in your browser.
Next.js 13 introduces the `app/` directory that can be used pretty much as the `pages/` directory. [More information available on their documentation.](https://beta.nextjs.org/docs/upgrade-guide#migrating-from-pages-to-app)

Everything is working fine? Good job! 🎉

💡 *Too long for you? Create a video-ready Next.js app with all api.video tools already installed in seconds with our official Next.js boilerplate! Read our short tutorial [here](https://api.video/blog/tutorials/api-video-next-js-boilerplate-start-your-video-project-the-easy-way)* 🤓

## Our video application structure 🏗️

Our goal here is to build a basic but fully operational video application. To do so, we will divide it into 3 pages:

- Our landing page to upload a video ⬆️
- A player view where you can playback a video 📺
- A videos list view where all of your videos will be displayed 🏄🏽‍♂️

Next.js provides a perfect navigation and page system that will help us build our project easily.

## Get your API key 🔑

To be able to upload and playback videos from [api.video](http://api.video), create and customize video players, and do many more things, you need an API key.
Get it from your [dashboard](https://dashboard.api.video/login) or [create a free account](https://dashboard.api.video/register) (yes, it’s free, really).

## A minimal layout first 💅🏽

The goal of this tutorial is to make a working video app without any great design.
But we need a minimal layout: top navigation, and a little CSS to keep things readable.
We will also create a loading component that is automatically displayed while the content of a route segment loads 😲

1. Replace your `src/app/layout.tsx` code with the following one.

Next.js 13 `app` directory allows you to declare layout globally (root layout) and for specific pages (nested layouts). The `src/app/layout.tsx` file also replaces the previous `pages/_app.js` and `pages/_document.js`. *[Read more about it here.](https://beta.nextjs.org/docs/routing/pages-and-layouts#layouts)*

2. Create a new file `src/app/loading.tsx` and add a simple component.

In Next.js 13, a `loading.[tsx,js]` file in the `app` directory is globally and automatically used by your whole application for loading state. How great it is! *[Read more about it here.](https://beta.nextjs.org/docs/data-fetching/streaming-and-suspense)*

## Upload a video with Next.js 13 ⬆️

In this section, we will create a page that allows a user to select a video file and upload it to [api.video](http://api.video).

We will keep this view as our home page, the `src/app/page.tsx` file.

1. We need to use the [api.video TypeScript video uploader](https://github.com/apivideo/api.video-typescript-uploader#readme) package to upload a video to your project. Install it by running one of the following commands

As you can see, you will need an upload token to upload a new video. You can create and find yours [here](https://dashboard.api.video/upload-tokens).

⚠️ *You can also decide to use an API key or an access token in the TypeScript video uploader, but it’s strongly discouraged because you’re exposing sensitive information*

Few things to notice here:

- `'use client'` : By default, the app directory’s components are [server components](https://beta.nextjs.org/docs/rendering/server-and-client-components). These components are great for rendering non-interactive content. 
However, if you want to allow client interaction in your component (React hooks, event listeners, browser-only APIs), you need to add the `'use client'` directive at the top of your component file.
- Next `<Link />` component: In Next.js 13, you don’t need to pass a `<a>` tag as children to the Link component.
- `onProgress` and `onPlayable` events: our TypeScript video uploader allows you to track upload progress whenever the uploaded video is playable.

Congratulations! You now have implemented a video upload solution into a Next.js application 👏🏽
Pretty easy right? Let’s move on to the next part: display your video list.

## Display a videos list with Next.js 13 🏄🏽

You can now upload videos to your [api.video](http://api.video) project. You can [watch and edit them through your dashboard](https://dashboard.api.video/videos). You can also implement this feature in your application. Let’s implement it together 🧑🏽‍💻

1. We need to use the [api.video Node.js client](https://github.com/apivideo/api.video-nodejs-client) to access our videos. Install it by running one of the following commands

2. Create a new videos directory under src/app/ and create a page.tsx file in it.
In Next.js 13, pages that are created under the app directory need to be named page.[tsx,js]. Read more about it here.

thumbnail_screenshot-2023-02-08-at-11-12-11.png

screenshot-2023-02-08-at-11-12-11.png

3. Edit your new src/app/videos/page.tsx file with the following code

This component is a perfect example of a Server Component. Instead of using Next.js `api` directory or `getServerSideProps` to fetch our videos from [api.video](http://api.video), we can directly do this from our component.

Congratulations! You displayed all your videos in seconds 🏎️

## Playback a video with Next.js 13 📺

In any application, a video needs a container to be played, which is often called a player. In our video app, we will use the [api.video React player](https://github.com/apivideo/api.video-react-player) to playback our videos.

We want to access and playback a video in two different ways:

- Once a new video is uploaded and playable, we want to display a player in the same view to playback it directly.
- If we go through our videos list, each item is a clickable link that redirects us to the video view, and thus the player.
1. Install the React player package by running one of the following commands

2. Replace your src/app/page.tsx (the uploader page) code with the one bellow

A video player will now appear when your uploaded video is ready to be played.

3. Create a new directory `src/app/videos/[videoId]` and a file `page.tsx` in it, and add the following code to it

The new `app` directory lets you create dynamic routes as previously. Here, we are reading the `videoId` URL parameter with the reserved `params` Next.js parameter and sending it to our React player.

4. Go back to your videos list view and try to click on one of them. You should be redirected to the player view where your video can be read  🎉

We are excited to see the creative solutions built with [api.video](http://api.video) and Next.js 13!
[Join our community](https://community.api.video/) to share anything about video with other passionate people 💬

large_14feb23.png

medium_14feb23.png

small_14feb23.png

thumbnail_14feb23.png

14feb23.png

How to create a Next.js 13 & React 18 video app

video api

api video plugin

JavaScript

No doubt, Next.js is one of the best React framework for full-stack web applications.

What if you want to create your own video application? A Next.js boilerplate with all [api.video](http://api.video) features is ready for you to begin your journey 🧑‍💻 

## What’s a boilerplate 🤔

A boilerplate is a unit of writing that can be reused without change. The idea is sometimes applied to reusable programming, and that’s the case here: our Next.js boilerplate is a starter pack containing all [api.video](http://api.video) features that anybody can use, without having to change anything in it to start a new project. 

Of course, you are free to modify anything once your application is running!

## What can I achieve with this boilerplate 🥇

After the boilerplate has been bootstrapped, you can run your brand-new application and enjoy [api.video](http://api.video) features!

Upload videos, display them as a list, and play any video in a fully customizable player.

[api.video](http://api.video) proposes many more endpoints to manage and create a complete video application.
Check [our documentation](https://docs.api.video/docs) to learn about this.

## Get started 🏁

Find out about ***[how to use our boilerplate](https://github.com/vercel/next.js/tree/canary/examples/with-apivideo)*** on the README file, or follow the guide bellow 👇 

1. Create a new Next.js application by running one of the following commands in a new terminal and following the command prompts.

2. Rename the `.env.local.example` file with `.env`.
3. Find your API key in the [api.video](http://api.video) dashboard [API keys section](https://dashboard.api.video/apikeys) and add its value to the API_KEY environment variable in the `.env` file.

💡 If you don’t already have an api.video account, create a free one [here](https://dashboard.api.video/register).

4. Start your application by running `yarn dev` in your terminal, and voilà!

You should be able to see a basic sample app from where you can upload videos and see them as a list.

large_screenshot-2023-01-31-at-17-24-04.png

medium_screenshot-2023-01-31-at-17-24-04.png

small_screenshot-2023-01-31-at-17-24-04.png

thumbnail_screenshot-2023-01-31-at-17-24-04.png

screenshot-2023-01-31-at-17-24-04.png

Everything in this application is set up to build a complete video application, from Next.js to api.video, enjoy coding! 

Find the full boilerplate in the official Next.js repository [right here](https://github.com/vercel/next.js/tree/canary/examples/with-apivideo).

large_02fev23.png

medium_02fev23.png

small_02fev23.png

thumbnail_02fev23.png

02fev23.png

api.video Next.js boilerplate: start your video project the easy way

Featured article

# api.video blog

Blog

Follow the api.video Blog to explore tutorials, video use cases, and learn about on-demand and live-streaming video updates.