Denzel documentation — Next.js
Everything you need to take Denzel for Next.js from the downloaded folder to a published blog or magazine. Read in this order, or jump to what you need.
| Guide | What it covers |
|---|---|
| Install and run | Requirements, install, the commands, what is in each folder |
| Editing the content | Editing text, images, posts, categories and authors, Home’s picks, the sidebar and the footer — no CMS needed |
| Making it look like your brand | Colours, the logo and the browser icon, fonts, text styles, spacing, motion, components, the style guide |
| Pages and sections | The header and the search, the sections of every page with a map of each, the 39 addresses, adding, removing and reordering pages and sections |
| Forms | Making the newsletter box deliver to you |
| Using a headless CMS | The collections and their fields, for connecting Sanity, Payload, Strapi, Directus or any other headless CMS |
| Going live | Pre-launch checklist, deploying, domains, what to do after launch |
| Troubleshooting and questions | Errors, questions and answers |
What is in the package
Section titled “What is in the package”- 6 kinds of page, 39 addresses:
- Home, Blog (every post) and the 404 page;
- a page for each of the 5 categories, the 6 authors and the 26 posts, built from the collections (Pages and sections).
- 3 collections in
src/content/collections/: posts (posts.ts, 26), categories (categories.ts, 5, among them the default “Uncategory”) and authors (authors.ts, 6, among them the default “Admin”). - 1 form: the newsletter box in the footer of every page, with a server action and four ways to deliver it (a log, a webhook, Mailchimp, Resend).
- Home’s picks, the sidebar’s lists and the footer’s two posts, chosen by slug in the page copy and in
site.ts. - A fixed header with the menu, the social links and a search across every post, category and author, and a menu that opens under the header on phones and tablets.
- A sidebar (About, Recent, Explore Topics) beside the lists of Home, the category and author pages and every post.
- Hover motion in the components, with reduced-motion support, and a style guide of every component at
/style-guide. - Search and sharing: a title, a description and a canonical link for every page, share cards, a browser icon for
light and dark themes,
sitemap.xmlandrobots.txt. - Placeholders: the photos in
public/images/are grey placeholders that show their sizes (the demo uses photos from Unsplash and Pexels, or made for the template, which can’t be sold with a template). - These docs (
docs/), the forms guide (Forms reference), the design system’s reference (Denzel design system),CHANGELOG.mdandLICENSE.md.
In a hurry: the first 15 minutes
Section titled “In a hurry: the first 15 minutes”npm installnpm run dev- Open http://localhost:3000.
- Put your site’s name, title, description and domain in
site, and your menu, social links, sidebar texts and footer in the same file,src/content/site.ts. - Replace the images in
public/images/(keep the file names and you are done). - Replace the logo (
public/images/logo.svg, Making it look like your brand), the browser icons (src/app/icon.svg,src/app/apple-icon.png) and the share image (public/opengraph-image.png). - Write your posts, categories and authors in
src/content/collections/, then name the posts Home, the sidebar and the footer should show (Editing the content). Search for “Denzel”: the demo’s name is written in many places. - Point the newsletter box at your list or inbox: Forms.
- Deploy: Going live.
Nothing else is required: the site has no database, no account to create and no paid service to run.
How this template is put together
Section titled “How this template is put together”- Content is data. All text and every collection item live in
src/content/. Pages read the collections throughsrc/lib/content.ts, which is why swapping in a CMS later touches one file, not the whole site. - Design is tokens. Colours, breakpoints and the easing curve are in
src/design-system/theme.css; text styles and springs insrc/design-system/tokens/. Change a token and every page follows (Making it look like your brand). - Components are shared. Every card, widget, button and section is in
src/design-system/orsrc/components/, and is shown at/style-guideon your own site. - One post card, seven looks. The slider, Editor’s Pick, Trending, Latest, the lists, the sidebar and the footer all
draw the same
PostCard, so a post is written once and shows everywhere it is picked.
Getting help
Section titled “Getting help”- Your licence terms: License.
- What changed in each release: Changelog.
- Support and updates: https://framebrick.co/support.
- Want it done for you? Marcframe, the studio behind this template, updates templates to your needs, builds custom templates and designs new sites. It’s also on Contra.