Simply copy and paste the following command line in your terminal to create your first Strapi project.
npx create-strapi-app
my-project
Hello, you wonderful people; in this post of many, I would like to introduce you to what we will be building.
This post is the first of many in our Epic Strapi Next.js 15 tutorial Series. You can find the outline for upcoming post here.
With the popularity of Next.js 15 and Strapi headless CMS and how they can empower you to build cool things, we are going to work on building a project together to cover all the awesome aspects of Next.js 15, the app folder, and all the new features including server components and server actions.
In this post, we will quickly look at what we will build and the topics we will cover, set up the basic structure of our project, and make our first commitment.
So, what will we be building?
So, I had a problem; I spent a lot of time on YouTube and found myself watching videos. Halfway through, I realized I could have avoided videos I was not entirely interested in if I had seen the summary first.
Wouldn't it be awesome if I could get the summary first and see if it deserves my full attention instead of watching the video?
I also use videos as learning resources. On top of video summarization, I wanted to create notes around the videos I watched that I could reference later.
And that is precisely what we will build, a video summarization app to summarize our YouTube videos with the power of AI.
No more wasted time committing to videos. We can just read the summaries.
Next.js is a front-end framework built on the React JavaScript library, which is known for creating engaging user interfaces.
It simplifies web development so you can focus on the most important parts, building the project for your clients.
And now, you can access all the new features of React, like React Server Components and Server Actions.
A major feature of Next.js is server-side rendering. This improves how fast web applications load and how well they rank on search engines, which is great for performance and SEO.
Next.js also has a static generation feature. This means it creates files before they're needed so they can load quickly without waiting for data to be fetched.
Additionally, Next.js provides incremental static regeneration. This feature updates static content with dynamic changes for pages that have not been pre-generated or updated since their initial creation.
To style our app, we will be using Tailwind and ShadcnUI.
To make building our application even easier, we will leverage the power of Strapi Headless CMS to manage our data and authentication.
Strapi is an open-source headless content management system (CMS). Unlike traditional CMSs, which are tightly coupled with the front-end presentation of your content, a headless CMS like Strapi provides backend management for your content and serves it via a RESTful or GraphQL API.
This means you can use Strapi to manage your content and then deliver it to any front-end framework or platform you choose, such as websites, mobile apps, or other server-side applications.
The main benefits of using Strapi include its flexibility, as it allows developers to customize the admin panel, APIs, and database queries to suit their specific needs.
It also supports many databases and can be easily integrated with popular front-end frameworks like React, Vue, and Angular.
In our case, we will be using Next.js 15.
Strapi is designed to streamline the content management process, making it easier for developers and content creators to work efficiently.
Get more done in less time.
In this tutorial, the goal is to cover the following Next.js and Strapi features.
Next.js 15
/app
dir,Protective Routes Middleware
UI Components built using Shadcn UI
Strapi
We will have a basic landing page with a top nav, hero sections, a benefits section, and a footer.
All the top nav, hero section, and footer content will be stored inside our Strapi instance.
We will handle auth using Strapi and protect our routes via the Next middleware file to check if an authorized user exists and redirect accordingly.
We will have a simple dashboard with a primary view showing available credits, notes, and summaries. As well as generate a summary form in the top navigation.
Generate Summary
Here, you will enter your YouTube video url, and it will make a call to Open AI to generate our summary based on the YouTube video transcript.
For this Next.js 15 tutorial, we will use the LangChain library to make a call to open AI since it gives us some additional features that we can use to extend our app in the future.
Summaries and Notes Page
Here, you can access your list of summaries and summaries details page, where you can update the text or delete the summary altogether.
We will have a similar section for our notes as well.
Account Page
Finally, we will have our account page, where we can update our users's first and last names and bio. As well as change our photo.
Most of the form submissions in our app will use Next Server Actions, which is pretty cool.
I hope you are excited to embark on this journey with me.
My goal is to build this tutorial in public and release new post/video per week.
All the progress will be saved in a public repo where you can follow along.
The goal is to build out our application that you can use later to add or extend in any way you desire.
We will cover all the important parts of Next.js and some features related to Strapi, such as middlewares, policies, routes, controllers, and services.
I hope you are just as excited as I am.
So let's get started.
Let's start by setting up our front end first. For this, we will be using Next.js 15
Let's start by creating a new folder called epic-next-course,
I am going to do this in my terminal by running the following command:
mkdir epic-next-course
Once we created our folder, let's navigate inside of it by typing cd epic-next-course
and run the following command:
1
npx create-next-app@latest
Select the following options:
create-next-app@15.0.3
Ok to proceed? (y) y
✔ What is your project named? … frontend
✔ Would you like to use TypeScript? … No / Yes
✔ Would you like to use ESLint? … No / Yes
✔ Would you like to use Tailwind CSS? … No / Yes
✔ Would you like your code inside a `src/` directory? … No / Yes
✔ Would you like to use App Router? (recommended) … No / Yes
✔ Would you like to use Turbopack for next dev? … No / Yes
✔ Would you like to customize the import alias (@/* by default)? … No / Yes
Creating a new Next.js app in /Users/paulbratslavsky/next-15-strapi-5-project/frontend.
Once your project has been created, let's navigate to our frontend folder with cd frontend
and run yarn dev
to start our frontend project.
Your project will start at http://localhost:3000.
We will use Tailwind with Shadcn UI components to make our app pretty. Shadcn UI is excellent because it allows you to install your UI components directly into your codebase and modify/extend them accordingly.
You can learn more here.
Let's now go through the setup steps. You can also reference this guide (https://ui.shadcn.com/docs/installation/next).
Run the CLI Run the shadcn-ui init command:
npx shadcn@latest init
Select the following options
➜ frontend git:(main) npx shadcn@latest init
✔ Preflight checks.
✔ Verifying framework. Found Next.js.
✔ Validating Tailwind CSS.
✔ Validating import alias.
✔ Which style would you like to use? › New York
✔ Which color would you like to use as the base color? › Neutral
✔ Would you like to use CSS variables for theming? … no / yes
✔ Writing components.json.
✔ Checking registry.
✔ Updating tailwind.config.ts
✔ Updating src/app/globals.css
Installing dependencies.
It looks like you are using React 19.
Some packages may fail to install due to peer dependency issues in npm (see https://ui.shadcn.com/react-19).
? How would you like to proceed? › - Use arrow-keys. Return to submit.
❯ Use --force
Use --legacy-peer-deps
You will have this prompt, and you can select the --force
option.
That's it. We now have Shadcn UI installed and ready to go.
You will see the new utils
folder and components.json
file.
Let's add our first component by running the following command in your frontend
folder, which will install our button component.
npx shadcn@latest add button
We now have a button inside our components folder.
Let's use it inside the page.tsx
file by replacing all the code with the following.
1
2
3
4
5
6
7
8
9
import { Button } from "@/components/ui/button";
export default function Home() {
return (
<main className="container mx-auto py-6">
<Button>Our Cool Button</Button>
</main>
);
}
Look at that amazing button.
Now that we know that our Shadcn UI component is working as expected. Let's finish up this first tutorial by setting up our Strapi instance.
For our backend, we are going to use Strapi headless CMS. Strapi allows you to build your backend in minutes instead of weeks.
It is highly customizable and easy to get started with.
You can learn more in the docs, but we will start by running the following command inside the project folder.
npx create-strapi-app@latest backend
You will see the following prompt.
Strapi v5.3.0 🚀 Let's create your new project
We can't find any auth credentials in your Strapi config.
Create a free account on Strapi Cloud and benefit from:
- ✦ Blazing-fast ✦ deployment for your projects
- ✦ Exclusive ✦ access to resources to make your project successful
- An ✦ Awesome ✦ community and full enjoyment of Strapi's ecosystem
Start your 14-day free trial now!
? Please log in or sign up.
Login/Sign up
❯ Skip
We will select skip
and hit enter.
You will be prompted with the following options.
? Do you want to use the default database (sqlite) ? Yes
? Start with an example structure & data? No
? Start with Typescript? Yes
? Install dependencies with npm? Yes
? Initialize a git repository? No
Strapi Creating a new application at /Users/paulbratslavsky/Desktop/work/epic-next-update/epic-next-course/backend
deps Installing dependencies with npm
To start our Strapi application, we will run the following command.
cd backend
yarn strapi develop
Once everything gets installed, you will be greeted by Strapi's register page.
Go ahead and create your first admin user. Once done, you will be greeted by the dashboard.
Congratulations. We now have our Strapi app set up.
In future posts, we will explore the Strapi dashboard in more detail. But for now, let's create our first collection type.
Our app will have a home page with our top navigation, hero section, features, and footer section.
Let's create our first collection type to store this data.
We will get it started in this post and continue it in the next post.
I want to show how easily we can add content to the Strapi application and get that data from our API.
Let's start by navigating to Content-Type Builder
under SINGLE TYPES
and clicking on create-new-single-type.
We are going to name it Home Page
.
We will add to text fields.
Text -> Short Text -> Title Text -> Long Text -> Description
Once done, click save.
Now, let's add some basic data.
After adding the title text and description, make sure to click publish.
Not let's take a look at how we can get our data from our API using Insomnia, but you can also use Postman
In future posts, of course, we will be getting out data from our Next.js frontend.
Now that we have our first data type let's see how we can query it using Postman in VS Code.
But first, we must give Strapi permission to serve those endpoints to our client.
Since this is public data, we can accomplish this with the following permissions.
Navigate to Settings -> USERS & PERMISSION PLUGIN -> Roles -> Public
Select Home Page and check the find checkbox.
We should now be able to access our data by making a GET
request to http://localhost:1337/api/home-page
.
Let's give it a try.
Awesome. We must get our initial Home Page data from our endpoint.
1
2
3
4
5
6
7
8
9
10
11
12
13
{
"data": {
"id": 2,
"documentId": "fcnlk9xwoqmogfxvfim713y4",
"title": "Home Page",
"description": "This is our first single type",
"createdAt": "2024-10-01T18:33:35.081Z",
"updatedAt": "2024-10-01T18:33:35.081Z",
"publishedAt": "2024-10-01T18:33:35.090Z",
"locale": null
},
"meta": {}
}
With introduction of Strapi 5, we now have a cleaner API response with a new key called documentId
. Which is a unique identifier for content.
Even though we return an id
in the response, we should use the documentId
for all our requests.
You can learn more about the changes here.
Before we go, let's call from our front end and see if we can render our initial data.
Let's see our Next.js and Strapi integration by creating create a basic function to fetch our data inside our Next.js application.
Since we are using Next.js 15, we can use RSC React Server Components.
Inside our frontend project, let's navigate to the src/app/page.tsx
file.
This is where we added our essential button component to test our CSS.
Let's make the following refactoring to fetch our data.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
async function getStrapiData(url: string) {
const baseUrl = "http://localhost:1337";
try {
const response = await fetch(baseUrl + url);
const data = await response.json();
return data;
} catch (error) {
console.error(error);
}
}
export default async function Home() {
const strapiData = await getStrapiData("/api/home-page");
const { title, description } = strapiData.data;
return (
<main className="container mx-auto py-6">
<h1 className="text-5xl font-bold">{title}</h1>
<p className="text-xl mt-4">{description}</p>
</main>
);
}
Once you make the following changes, ensure your project is running, and navigate to http://localhost:3000
, you should see the next.
Excellent job; we now know we can get data from our backend to our frontend.
We will continue building the home page, navigation, and footer in the next post.
Amazing job, everyone. We did it, we now have our Next.js and Strapi integration. We have jump-started our Next.js 15 and Strapi journey.
We set up both our frontend and backend of our video summarization app. We are now ready to continue building the rest of the project.
Here is the repo for the project with the current progress.
I want to build this out in public, so feel free to add comments and questions in the GitHub issues.
I hope you had as much fun as I did, and I will see you in the next post.
This project has been updated to use Next.js 15 and Strapi 5.
If you have any questions, feel free to stop by at our Discord Community for our daily "open office hours" from 12:30 PM CST to 1:30 PM CST.
If you have a suggestion or find a mistake in the post, please open an issue on the GitHub repository.
You can also find the blog post content in the Strapi Blog.
Feel free to make PRs to fix any issues you find in the project or let me know if you have any questions.
Happy coding!