Semono documentation — Next.js
Everything you need to take Semono for Next.js from the downloaded folder to a published site. 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, the two videos, services, testimonials, posts, careers, legal pages, the team and client logos — no CMS needed |
| Making it look like your brand | Colours, the logo, fonts, text styles, spacing, motion and the page change, components, the style guide |
| Pages and sections | The header, the sections of every page with a map of each, adding, removing and reordering pages and sections |
| Forms | Making the three forms 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”- 13 kinds of page, 33 addresses:
- Home, About, Team, Careers, Services, Testimonial, Blog, Contact and the 404 page;
- a page for each of the 5 positions, 6 services, 12 posts and 2 legal pages, built from the collections;
- Services and Careers live at
/serviceand/career, in the singular (Pages and sections).
- 7 collections in
src/content/collections/: services (6), testimonials (7), posts (12), careers (5), legal pages (2), the team (6) and client logos (10). - 3 forms: the inquiry on Contact, a consultation form on every service page and an application form on every career page, with a server action each and four ways to deliver them (a log, a webhook, Mailchimp, Resend).
- 2 videos: play-on-click cards on Home and About. The demo’s clips are Pexels stock videos played from Pexels’ servers; the package carries no video.
- A fixed header that never hides: over the photo on Home, turning light at the “About Semono” block, under a spacer on every other page; and a page change, a slide between pages, that switches itself off for visitors who ask their system for less motion.
- 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, icons,
sitemap.xmlandrobots.txt. - Placeholders: the photos in
public/images/are grey placeholders that show their sizes (the demo uses photos from Unsplash, which can’t be sold with a template). The logo and the sample client logos are drawn for the template. - These docs (
docs/), the forms guide (Forms reference), the design system’s reference (Semono 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 name, title, description and domain in
src/content/site.ts, and your menu, contact details, footer and social links in the same file. - Replace the images in
public/images/(keep the file names and you are done), including the portraits and the client logos, and the two videos (Editing the content). - Replace the logo (Making it look like your brand), the browser icons in
src/app/(icon.svg,apple-icon.png) and the share image (public/opengraph-image.png). - Edit the page copy in
src/content/pages/, and your services, testimonials, posts, careers, legal pages, team and clients insrc/content/collections/. Search for “Semono”: the demo’s firm is named in many places. - Point the three forms at your 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 easing curves 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 button, card, form field and section is in
src/design-system/orsrc/components/, and is shown at/style-guideon your own site. - Blocks are shared too. The closing call to action, the counters, the process steps and the client cards appear on several pages from one copy: Home’s file holds them (Pages and sections).
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.