Notes from Next.js Crash Course from Traversy Media YouTube channel.
🚀 View Demo
Create pages in folders with the name of the url slug
app/page.js
is the home page
Add new pages under a folder
app/about/page.jsx
Nested routes
Add a new folder under an existing one
app/about/team/page.jsx
app/layout.js
Is the main layout component.
If you need an additional layout, you can create for each page.
app/about/layout.jsx
This layout will be used in the about page and any nested page/router.
The metadata
object will have all the global meta tags info.
app/layout.jsx
will have the metadata by default- In new pages you need to export the metadata variable
- If you add the metadata in a layout it will affect all the child routes
// app/about/page.jsx
export const metadata = {
title: 'About page',
};
const AboutPage = () => {
Import the font you need at the top, specify weights and subsets in an object variable, and apply to the body tag using dot notation.
// app/layout.jsx
import { Montserrat } from 'next/font/google';
const montserrat = Montserrat({
weight: ['400', '700'],
subsets: ['latin'],
});
export default function RootLayout({ children }) {
return (
<html lang='en'>
<body className={montserrat.className}>{children}</body>
</html>
);
}
Add a new folder under app
, use PascalCase for the component name.
app/components/Header.jsx
By default all components are server side components unless you specify a client component.
There pros and cons of RSC
- Loads faster, smaller client bundle size, SEO Friendly, hide sensitive data from the client, more secure, improved DX
The cons are
- Not as interactive, no component state and no lifecycle methods.
Add 'use client'
at the top of the file.
We can use fetch
with an async function that return a promise that can be consumed in the page component.
async function fetchRepos() {
const response = await fetch('https://github.com/gitapi/users/uxmoon/repos');
const repos = await response.json();
return repos;
}
const ReposPage = async () => {
const repos = await fetchRepos();
return (
<>
<h1>Repos page</h1>
{repos[0].name}
</>
);
};
export default ReposPage;
You can add a loading page component to display a spinner without using state like in React. Works automatically with a RSC and it’s fetching data it will display the loading page.
app/loading.jsx
const LoadingPage = () => {
return (
<div className='loader'>
<div className='spinner'></div>
</div>
);
};
export default LoadingPage;
When we click in a repo link we need to display a page.
app/code/repos/page.jsx ==> display repos list
app/code/repos/[name]/page.jsx ==> display repo details
In the repos list page we added a Link
that points to /code/repos/${name}
and the page for each item displays all the details.
const RepoPage = ({ params: { name } }) => {
return (
<div className='card'>
<h2>{name}</h2>
<p>Repo details</p>
</div>
);
};
export default RepoPage;
We want to display the information using a Suspense Boundary.
We create a couple of components for a repo, to display a title, description and stats. And another to display the directories. The latter will take 3 seconds to display the information.
We import Suspense
from React and wrap each component.
import { Suspense } from 'react';
import Repo from '@/app/components/Repo';
import RepoDirs from '@/app/components/RepoDirs';
import Link from 'next/link';
const RepoPage = ({ params: { name } }) => {
return (
<div className='card'>
<Link href='/code/repos' className='btn btn-back'>
Back to repository list
</Link>
<Suspense fallback={<div>Loading repo...</div>}>
<Repo name={name} />
</Suspense>
<Suspense fallback={<div>Loading directories...</div>}>
<RepoDirs name={name} />
</Suspense>
</div>
);
};
export default RepoPage;
It will improve the UX to display the information and notify the user of an action taking place.
By default NextJs store cache indefinitely but there’s an option.
Tells next js how often to check for data.
Add an object to the fetch API as a second parameter. It’s ideal for data that often changes.
async function fetchRepoContents(name) {
const reponse = await fetch(
`https://github.com/gitapi/repos/uxmoon/${name}/contents`,
{
next: { revalidate: 60 },
}
);
const repo = await reponse.json();
return repo;
}
Allows you to create custom request handler for a given route.
Path: app/api
Example: app/api/hello/route.js
URL: http://localhost:3000/api/hello
You can have router handlers within your page routes, but in the api
folder it will be prefixed with /api/
In the file you define the method GET
or POST
Add a route that return courses.
Files: app/api/courses/data.json,router.js
URL: http://localhost:3000/api/courses
// api/courses/router.js
import { NextResponse } from 'next/server';
import courses from './data.json';
export async function GET(request) {
return NextResponse.json(courses);
}
URL: http://localhost:3000/api/courses/search?query=react
How to get the query value.
import { NextResponse } from 'next/server';
import courses from '../data.json';
export async function GET(request) {
const { searchParams } = new URL(request.url);
console.log(searchParams.get('query')); // --> query=react gets react
const query = searchParams.get('query');
const filteredCourses = courses.filter((course) => {
return course.title.toLowerCase().includes(query.toLocaleLowerCase());
});
return NextResponse.json(filteredCourses);
}
Get data from the body
Files: app/api/courses/router.js
In Postman, create a new tab, set to POST and select Raw under Body to add a new course manually.
export async function POST(request) {
const { title, description, level, link } = await request.json();
const newCourse = {
id: uuidv4(),
title,
description,
level,
link,
};
courses.push(newCourse);
return NextResponse.json(courses);
}
Fetching from the homepage.
We update app/page.jsx
to 'use client'
to add React hooks.
- Add
'use client'
to convert it to a client side component - The
loading.jsx
page will not automatically work, add it manually - Add 2 states for the courses list and the loading animation
- Add a side effect to fetch all courses
- Add search and courses list components
Create a search form component and update the course list component.