Lookis documentation — Next.js
Everything you need to take Lookis 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, projects, services, testimonials and the gallery — no CMS needed |
| Making it look like your brand | Colours, the logo, fonts, text styles, spacing, motion, 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 contact form 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”- 8 kinds of page, 25 addresses:
- Home, About, Portfolio, Services, Contact and the 404 page;
- a page for each of the 16 projects and the 4 services, built from the collections (Pages and sections).
- 2 collections in
src/content/collections/: projects (portfolio.ts, 16) and services (services.ts, 4). - A portfolio with filter tabs: All, then one tab per service; four projects at first and four more as the visitor scrolls.
- 1 form: the inquiry on Contact (Name, Email, Message), with a server action and four ways to deliver it (a log, a webhook, Mailchimp, Resend).
- A sticky header with a clock that shows the time of the photographer’s town, and a phone menu.
- 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, light and dark
browser icons,
sitemap.xmlandrobots.txt. - Placeholders: the photos in
public/images/are grey placeholders that show their sizes (the demo uses photos from Unsplash and Pexels, which can’t be sold with a template). The logo is drawn for the template. - These docs (
docs/), the forms guide (Forms reference), the design system’s reference (Lookis 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
site, your name, town and time zone inowner, and your menu, social links, booking link, contact details 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 (Making it look like your brand), the browser icons (
public/icon-light.png,public/icon-dark.png,src/app/apple-icon.png) and the share image (public/opengraph-image.png). - Edit the page copy in
src/content/pages/, and your projects and services insrc/content/collections/. Search for “Daniel Mercer”, “Daniel” and “Asheville”: the demo’s photographer and town are named in many places. - Point the contact form 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 testimonials and the “See what I do” gallery appear on several pages from one copy in
src/content/pages/shared.ts(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.