Added lesson 10

Author: gitdagray

README.md

@@ -78,4 +78,5 @@
 - 🔗 [Chapter 7 - Route Handlers for API Routes](https://github.com/gitdagray/next-js-course/tree/main/next07)
 - 🔗 [Chapter 8 - Build a REST API](https://github.com/gitdagray/next-js-course/tree/main/next08)
 - 🔗 [Chapter 9 - Middleware](https://github.com/gitdagray/next-js-course/tree/main/next09)
+- 🔗 [Chapter 10 - Background & On-Demand Revalidation](https://github.com/gitdagray/next-js-course/tree/main/next10)
 

next10/.eslintrc.json

@@ -0,0 +1,3 @@
+{
+  "extends": "next/core-web-vitals"
+}

next10/.gitignore

@@ -0,0 +1,36 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.js
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# local env files
+.env*.local
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts

next10/README.md

@@ -0,0 +1,38 @@
+This is a [Next.js](https://nextjs.org/) project bootstrapped with [`create-next-app`](https://github.com/vercel/next.js/tree/canary/packages/create-next-app).
+
+## Getting Started
+
+First, run the development server:
+
+```bash
+npm run dev
+# or
+yarn dev
+# or
+pnpm dev
+```
+
+Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
+
+You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.
+
+[API routes](https://nextjs.org/docs/api-routes/introduction) can be accessed on [http://localhost:3000/api/hello](http://localhost:3000/api/hello). This endpoint can be edited in `pages/api/hello.ts`.
+
+The `pages/api` directory is mapped to `/api/*`. Files in this directory are treated as [API routes](https://nextjs.org/docs/api-routes/introduction) instead of React pages.
+
+This project uses [`next/font`](https://nextjs.org/docs/basic-features/font-optimization) to automatically optimize and load Inter, a custom Google Font.
+
+## Learn More
+
+To learn more about Next.js, take a look at the following resources:
+
+- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
+- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
+
+You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js/) - your feedback and contributions are welcome!
+
+## Deploy on Vercel
+
+The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
+
+Check out our [Next.js deployment documentation](https://nextjs.org/docs/deployment) for more details.

next10/app/api/hello/route.ts

@@ -0,0 +1,3 @@
+export async function GET(request: Request) {
+  return new Response('Hello, Next.js!')
+}

next10/app/components/ListItem.tsx

@@ -0,0 +1,19 @@
+import Link from "next/link"
+import getFormattedDate from "@/lib/getFormattedDate"
+
+type Props = {
+    post: BlogPost
+}
+
+export default function ListItem({ post }: Props) {
+    const { id, title, date } = post
+    const formattedDate = getFormattedDate(date)
+
+    return (
+        <li className="mt-4 text-2xl dark:text-white/90">
+            <Link className="underline hover:text-black/70 dark:hover:text-white" href={`/posts/${id}`}>{title}</Link>
+            <br />
+            <p className="text-sm mt-1">{formattedDate}</p>
+        </li>
+    )
+}

next10/app/components/MyProfilePic.tsx

@@ -0,0 +1,16 @@
+import Image from "next/image"
+
+export default function MyProfilePic() {
+    return (
+        <section className="w-full mx-auto">
+            <Image
+                className="border-4 border-black dark:border-slate-500 drop-shadow-xl shadow-black rounded-full mx-auto mt-8"
+                src="/images/profile-photo-600x600.png"
+                width={200}
+                height={200}
+                alt="Dave Gray"
+                priority={true}
+            />
+        </section>
+    )
+}

next10/app/components/Navbar.tsx

@@ -0,0 +1,28 @@
+import Link from "next/link"
+import { FaYoutube, FaTwitter, FaGithub, FaLaptop } from "react-icons/fa"
+
+export default function Navbar() {
+    return (
+        <nav className="bg-slate-600 p-4 sticky top-0 drop-shadow-xl z-10">
+            <div className="prose prose-xl mx-auto flex justify-between flex-col sm:flex-row">
+                <h1 className="text-3xl font-bold text-white grid place-content-center mb-2 md:mb-0">
+                    <Link href="/" className="text-white/90 no-underline hover:text-white">Dave Gray</Link>
+                </h1>
+                <div className="flex flex-row justify-center sm:justify-evenly align-middle gap-4 text-white text-4xl lg:text-5xl">
+                    <Link className="text-white/90 hover:text-white" href="https://www.youtube.com/@DaveGrayTeachesCode">
+                        <FaYoutube />
+                    </Link>
+                    <Link className="text-white/90 hover:text-white" href="https://courses.davegray.codes/">
+                        <FaLaptop />
+                    </Link>
+                    <Link className="text-white/90 hover:text-white" href="https://github.com/gitdagray">
+                        <FaGithub />
+                    </Link>
+                    <Link className="text-white/90 hover:text-white" href="https://twitter.com/yesdavidgray">
+                        <FaTwitter />
+                    </Link>
+                </div>
+            </div>
+        </nav>
+    )
+}

next10/app/components/Posts.tsx

@@ -0,0 +1,17 @@
+import { getSortedPostsData } from "@/lib/posts"
+import ListItem from "./ListItem"
+
+export default function Posts() {
+    const posts = getSortedPostsData()
+
+    return (
+        <section className="mt-6 mx-auto max-w-2xl">
+            <h2 className="text-4xl font-bold dark:text-white/90">Blog</h2>
+            <ul className="w-full">
+                {posts.map(post => (
+                    <ListItem key={post.id} post={post} />
+                ))}
+            </ul>
+        </section>
+    )
+}

next10/app/favicon.ico

@@ -0,0 +1,3 @@
+@tailwind base;
+@tailwind components;
+@tailwind utilities;

next10/app/globals.css

@@ -0,0 +1,24 @@
+import './globals.css'
+import Navbar from './components/Navbar'
+import MyProfilePic from './components/MyProfilePic'
+
+export const metadata = {
+  title: "Dave's Blog",
+  description: 'Created by Dave Gray',
+}
+
+export default function RootLayout({
+  children,
+}: {
+  children: React.ReactNode
+}) {
+  return (
+    <html lang="en">
+      <body className="dark:bg-slate-800">
+        <Navbar />
+        <MyProfilePic />
+        {children}
+      </body>
+    </html>
+  )
+}

next10/app/layout.tsx

@@ -0,0 +1,17 @@
+import Posts from "./components/Posts"
+
+export const revalidate = 10
+
+export default function Home() {
+  return (
+    <main className="px-6 mx-auto">
+      <p className="mt-12 mb-12 text-3xl text-center dark:text-white">
+        Hello and Welcome 👋&nbsp;
+        <span className="whitespace-nowrap">
+          I&apos;m <span className="font-bold">Dave</span>.
+        </span>
+      </p>
+      <Posts />
+    </main>
+  )
+}

next10/app/page.tsx

@@ -0,0 +1,5 @@
+export default function NotFound() {
+    return (
+        <h1>The requested post does not exist.</h1>
+    )
+}

next10/app/posts/[postId]/not-found.tsx

@@ -0,0 +1,59 @@
+import getFormattedDate from "@/lib/getFormattedDate"
+import { getSortedPostsData, getPostData } from "@/lib/posts"
+import { notFound } from "next/navigation"
+import Link from "next/link"
+
+export function generateStaticParams() {
+    const posts = getSortedPostsData() //deduped!
+
+    return posts.map((post) => ({
+        postId: post.id
+    }))
+}
+
+export function generateMetadata({ params }: { params: { postId: string } }) {
+
+    const posts = getSortedPostsData() //deduped!
+    const { postId } = params
+
+    const post = posts.find(post => post.id === postId)
+
+    if (!post) {
+        return {
+            title: 'Post Not Found'
+        }
+    }
+
+    return {
+        title: post.title,
+    }
+}
+
+export default async function Post({ params }: { params: { postId: string } }) {
+
+    const posts = getSortedPostsData() //deduped!
+    const { postId } = params
+
+    if (!posts.find(post => post.id === postId)) {
+        return notFound()
+    }
+
+    const { title, date, contentHtml } = await getPostData(postId)
+
+    const pubDate = getFormattedDate(date)
+
+    return (
+        <main className="px-6 prose prose-xl prose-slate dark:prose-invert mx-auto">
+            <h1 className="text-3xl mt-4 mb-0">{title}</h1>
+            <p className="mt-0">
+                {pubDate}
+            </p>
+            <article>
+                <section dangerouslySetInnerHTML={{ __html: contentHtml }} />
+                <p>
+                    <Link href="/">← Back to home</Link>
+                </p>
+            </article>
+        </main>
+    )
+}

next10/app/posts/[postId]/page.tsx

@@ -0,0 +1,19 @@
+---
+title: 'My New Post'
+date: '2023-04-19'
+---
+
+We recommend using **Static Generation** (with and without data) whenever possible because your page can be built once and served by CDN, which makes it much faster than having a server render the page on every request.
+
+You can use Static Generation for many types of pages, including:
+
+- Marketing pages
+- Blog posts
+- E-commerce product listings
+- Help and documentation
+
+You should ask yourself: "Can I pre-render this page **ahead** of a user's request?" If the answer is yes, then you should choose Static Generation.
+
+On the other hand, Static Generation is **not** a good idea if you cannot pre-render a page ahead of a user's request. Maybe your page shows frequently updated data, and the page content changes on every request.
+
+In that case, you can use **Server-Side Rendering**. It will be slower, but the pre-rendered page will always be up-to-date. Or you can skip pre-rendering and use client-side JavaScript to populate data.

next10/blogposts/new.md

@@ -0,0 +1,11 @@
+---
+title: 'Two Forms of Pre-rendering'
+date: '2023-03-14'
+---
+
+Next.js has two forms of pre-rendering: **Static Generation** and **Server-side Rendering**. The difference is in **when** it generates the HTML for a page.
+
+- **Static Generation** is the pre-rendering method that generates the HTML at **build time**. The pre-rendered HTML is then _reused_ on each request.
+- **Server-side Rendering** is the pre-rendering method that generates the HTML on **each request**.
+
+Importantly, Next.js lets you **choose** which pre-rendering form to use for each page. You can create a "hybrid" Next.js app by using Static Generation for most pages and using Server-side Rendering for others.

next10/blogposts/pre-rendering.md

@@ -0,0 +1,19 @@
+---
+title: 'When to Use Static Generation vs. Server-side Rendering'
+date: '2023-03-17'
+---
+
+We recommend using **Static Generation** (with and without data) whenever possible because your page can be built once and served by CDN, which makes it much faster than having a server render the page on every request.
+
+You can use Static Generation for many types of pages, including:
+
+- Marketing pages
+- Blog posts
+- E-commerce product listings
+- Help and documentation
+
+You should ask yourself: "Can I pre-render this page **ahead** of a user's request?" If the answer is yes, then you should choose Static Generation.
+
+On the other hand, Static Generation is **not** a good idea if you cannot pre-render a page ahead of a user's request. Maybe your page shows frequently updated data, and the page content changes on every request.
+
+In that case, you can use **Server-Side Rendering**. It will be slower, but the pre-rendered page will always be up-to-date. Or you can skip pre-rendering and use client-side JavaScript to populate data.

next10/blogposts/ssg-ssr.md

@@ -0,0 +1,3 @@
+export default function getFormattedDate(dateString: string): string {
+    return new Intl.DateTimeFormat('en-US', { dateStyle: 'long' }).format(new Date(dateString))
+}