To get started, first install dependencies via npm:

npm install

Next, create a .env.local file in the root of your project and set the NEXT_PUBLIC_SITE_URL environment variable to your site's public URL:

NEXT_PUBLIC_SITE_URL=https://example.com

Then start the development server:

npm run dev

Finally, open http://localhost:3000 in your browser to view the website.

The template is built as a pretty standard Next.js website, but using the src folder so things like the app directory are located at ./src/app instead of being top-level.

You can update your site's metadata in ./src/app/layout.tsx.

The main hero section for the site that includes your logo, headline, description, and links are all located in ./src/components/Intro.tsx.

All of the changelog entries are stored in one big ./src/app/page.mdx file. We were inspired to set it up this way by how projects commonly maintain plaintext CHANGELOG files, and thought it would be cool to parse this sort of format and turn it into a nicely designed site.

Each changelog entry should be separated by a horizontal rule (---) and should include an <h2> with a date, specified as an MDX annotation:

---

![](@/images/your-screenshot.png)

## My new changelog entry {{ date: '2023-04-06T00:00Z' }}

Your content...

You can find the newsletter sign up form in ./src/components/SignUpForm.tsx — if you have a newsletter you'll want to wire this up with whatever mailing list software you use to get it to actually work.

The site uses a route handler to automatically generate an RSS feed at run time based on the rendered home page.

You can edit the metadata for the feed (like the title and description) in ./src/app/feed.xml/route.ts.

Make sure to set your NEXT_PUBLIC_SITE_URL environment variable as the RSS feed needs this to generate the correct links for each entry.

To learn more about the technologies used in this site template, see the following resources:

• Tailwind CSS - the official Tailwind CSS documentation
• Next.js - the official Next.js documentation
• Motion One - the official Motion One documentation
• MDX - the official MDX documentation