Cerette documentation — Astro
Everything you need to take Cerette for Astro 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 video, projects, services, testimonials, the team, posts and legal pages — 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 inquiry 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”- 11 kinds of page, 32 addresses in the sitemap:
- Home, About, Projects, Services, Blog, Contact and the 404 page;
- a page for each of the 6 projects, 6 services, 12 posts and 2 legal pages, built from the collections (Pages and sections).
- 6 collections in
src/content/collections/: the projects (6), the services (6), the testimonials (6), the team (12), the blog posts (12) and the legal pages (2). - 2 forms: the inquiry form on Contact and Services, and the same form on every service page, where the project type starts with the service’s name (Name, Email, Phone, Location, Project type, Project budget, Project details). They run in demo mode until you give them a destination: a form service or webhook on any static host, or the site’s own route with four ways to deliver (a log, a webhook, Mailchimp, Resend).
- A Home page with a background video under the title, the projects, the founder’s quote, a services switcher, “Why Cerette”, the achievements and awards, the testimonials and the newest posts.
- A header fixed at the top: transparent over Home’s video and a project’s cover, it turns the page colour once you scroll past them; on phones a menu opens under the bar.
- Motion in the components (the Home hero’s text appearing character by character, titles word by word, blocks
rising into view, the hovers), 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 and a
home screen icon,
sitemap.xmlandrobots.txt. - Placeholders: the photos in
src/assets/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 Home hero’s video in the demo is a file hosted elsewhere, not part of the template: put your own (Editing the content). The Cerette logo is drawn for the template. - These docs (
docs/), the forms guide (Forms reference), the design system’s reference (Cerette 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:4321.
- Put your name, title, description and domain in
src/content/site.json, and your menu, footer, phone, e-mail, address and social links in the same file. The Contact page has its own copy of the e-mail, phone, address and hours, insrc/content/pages/contact.json. - Replace the photos in
src/assets/images/(keep the file names and you are done) and write analtfor each in the content (Editing the content). Replace the Home hero’s video with your own. - Put your booking page in the “Book a call” and “Schedule Consultation” buttons (they open
https://cal.com/) (Editing the content). - Replace the logo (Making it look like your brand), the icons in
public/(icon.svg,apple-icon.png) and the share image (public/opengraph-image.png). - Edit the page copy in
src/content/pages/, and your projects, services, testimonials, team, posts and legal pages insrc/content/collections/. Search for “Cerette”: the demo’s studio is named in the copy, the legal pages and the footer. - Point the 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/, as JSON. Pages read the collections throughsrc/lib/content.ts, andsrc/content.config.tssays where each collection comes from, 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 motion timings 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. - Collections feed several places. The services also fill the footer’s Services column and a project’s services, the legal pages the footer’s Legal column, the testimonials appear on Home and Projects, and the newest posts on Home (Pages and sections).
- No framework in the browser. The pages are static HTML. Each interactive part has a small TypeScript script in
src/design-system/scripts/(the header’s is insrc/components/site/) whoseinit*()function the component’s<script>calls, and hovers aredata-hover/data-motionattributes played byscripts/hover.ts(Making it look like your brand).
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.