Editing the site — Compose Digi HTML
Every page of Compose Digi’s HTML edition is a plain file you edit in a code editor: where everything is, and how to add a post, a project, a service, a job opening or a page.
Open it
Section titled “Open it”Double-click index.html: the site opens in your browser and every link works, straight from the folder. To see it
exactly as a host serves it (and to test the form and the 404 page), run a small local server from the folder:
npx serve .npm start runs the same command. Then edit the files in a code editor and reload the browser to see the change.
What is where
Section titled “What is where”index.html, about.html, contact.htmlservices.html the Services page (every service as a card, the process chart, the testimonials)projects.html every project as a cardcareers.html every job openingblog.html every post as a card404.html shown for addresses that don't existstyle-guide.html every component with its name (noindex; delete it if you don't want it)services/*.html one page per serviceprojects/*.html one page per project (case study)careers/*.html one page per job openingblog/*.html one page per postassets/css/style.css the stylesheet (generated — see design.md)assets/js/main.js the site's scripts (you rarely need to touch it)assets/js/config.js your settings: form endpointassets/images/ photos, portraits, the client logos, the logo as a fileassets/fonts/ DM Sans and Intericon.svg, apple-icon.png, opengraph-image.pngsitemap.xml, robots.txtsrc/css/style.css the stylesheet's source: colours, breakpoints, fonts, animationsPages and sections describes every page, section by section.
Find the words on the page and change them in the HTML. Keep the tags and classes around them, because they carry the layout. A heading looks like this:
<h2 class="text-[30px] md:text-[36px] lg:text-[42px] font-medium leading-[1.2]"> Showcasing Our Success Stories</h2>Change the words, leave the class. Long lines are wrapped onto several lines in the files, so when you search for a
sentence, search for a few words of it. Ampersands are written & (Passion & Expertise), some apostrophes
' (We're a dynamic…) and quotation marks "; the demo also uses the typographic ’ (we’re). Typing
' and " in text works too; & should stay &.
The labels of the round buttons (“Contact Us”, “More Services”, “Get in touch”, “Book an intro call” …), of the header’s
links and of the phone menu’s “Menu” are written three times: once to size the element (class="opacity-0", the copy
screen readers read) and twice in the copy that rolls up on hover (aria-hidden="true"). Change all three:
<span class="opacity-0">Contact Us</span><span aria-hidden="true" …><span>Contact Us</span><span>Contact Us</span></span>The underlined text links (“Book a call”, “Our Services”, “More Details”, “See more projects”, “Scroll to Explore”) are
written once. A few titles keep their line breaks as written (whitespace-pre): the Projects title breaks after
“Crafting Success,” because the line break is in the file; write it on one line to let it wrap by itself.
Text that repeats on every page
Section titled “Text that repeats on every page”The header, the footer, your links and your contact details are copied into every page. Change them once for all files
with your editor’s Find in Files / Replace in Files (VS Code: Ctrl/Cmd + Shift + H):
| Replace | With |
|---|---|
https://compose-digi-html-marcframe.vercel.app |
Your domain, e.g. https://www.youragency.com (canonical links, share cards, sitemap.xml, robots.txt) |
hello@example.com |
Your e-mail: the footer of every page |
careers@example.com |
Your hiring e-mail: “How to Apply” on every job opening |
001 265 847 483 and tel:001265847483 |
Your phone, as shown and as dialled (the footer) |
23 Artist Avenue, Suite 456, Imaginopolis, 98765, Wonderland |
Your address (the footer) |
https://cal.com/ |
Your booking page: “Book a call” in the Home hero and “Book a Call” in the footer |
https://instagram.com, https://x.com, https://facebook.com, https://behance.net |
Your profiles: the footer’s “Social Media” column (with the link texts Instagram … Behance); behance.net and x.com are also the team members’ buttons on About |
https://behance.com, https://dribbble.com, https://instagram.com, https://twitter.com |
Your profiles: the four round buttons in the page headers of About, Services, Projects, Blog and every service page (named by aria-label). Remove the <li> of a network you don’t use |
Optimize your success with our ROI-driven digital marketing agency. |
The line under the logo in the footer |
aria-label="Compose" |
Your name: the name of the logo links (header, phone header and footer) for screen readers |
| Compose in <title> and share tags |
| Your Name (the Home title, Compose - Digital Marketing Agency, has no suffix) |
content="Compose" |
Your site’s name (application-name and og:site_name) |
Compose — digital marketing agency website template |
A description of your share image (og:image:alt) |
Include the .html, .xml and .txt files. Review each change before replacing all: “Compose” also appears in the copy
(“At Compose, …”, the founder’s quote, “Get in Touch with Compose”, the job openings), which you may want to rewrite
rather than replace. The year in the footer updates itself (data-current-year).
The footer’s big line, “Tell Us Your New Ideas”, is sized to fill its row on tablets and desktops:
md:text-[8.532cqw] on its <span> is the size that makes those words fit. With other words, try a new value (a
shorter line takes a larger one) and rebuild the stylesheet (Making it look like your brand).
Sections that repeat on several pages
Section titled “Sections that repeat on several pages”Some sections are copied into several pages. Change them in every copy (find and replace in files works for text):
| Section | Pages |
|---|---|
| Header and footer (with the footer’s ticker of service names) | Every page |
| The page header’s four social buttons | about.html, services.html, projects.html, blog.html, every page in services/ |
“Who are we?” (the statement, the paragraphs, about-1.jpg and about-2.jpg) |
index.html, about.html (“WHO WE ARE?”) |
| The dark “If you are ready for a change…” box with “Get in touch” and “See more projects” | index.html, every page in projects/ |
| The service names | Home’s service list (the first six), the Services cards, every service page’s title and “Other Services”, the project pages’ service links, the contact form’s checkboxes, the footer’s ticker |
| The project cards | The Home ticker (the first four) and project list (the fourth to the eighth), projects.html, “More Projects” on every page in projects/ |
| A project’s client quote | Its card on Home, its project page and, for the first three projects, the Services slider |
| The post cards | index.html (the newest three), blog.html (all twelve), “More Blog” and Prev / Next on every page in blog/ |
| The job openings | careers.html (all twelve), “Open Positions” on about.html (the first three) |
The tickers
Section titled “The tickers”Three rows move sideways without end: the projects in the Home hero, the six client logos on About and the two rows of
service names in every footer. Each is a <div data-ticker data-speed="…"> whose items are written three times: once
for screen readers, then twice more in copies marked aria-hidden="true" inert, so that the row never runs out. Change
an item in all three copies. data-speed is in pixels per second (20 for the projects, 15 for the logos, 30 for the
footer rows). The rows stand still for visitors who ask for reduced motion.
The services
Section titled “The services”Home shows the first six services as rows: one is always open (the first, when the page loads), and opening another
closes it. The Services page shows all eight as cards, and each has its own page in services/.
- On Home, each row is an
<h3>holding a<button aria-expanded>(id="home-services-button-0"…) with the name, followed by its panel (id="home-services-panel-0"…, matching the button’saria-controls) with the summary and “More Details”. The open row’s button saysaria-expanded="true", its round icon’sdata-accordion-fillhasstyle="opacity: 1", and its panel has noaria-hiddenandstyle="visibility: visible; height: auto". A closed row:aria-expanded="false",opacity: 0, and a panel witharia-hidden="true"andstyle="visibility: hidden; height: 0px". To add a row, copy a closed one and number its two ids on. - On the Services page, each service is a card (photo, name, summary, “More Details”) linking to its page.
- The service page holds the name (
<h1>and the<title>), the summary, the photo, “What We Offer”, “Key Benefits”, the plan card (the plans) and “Other Services”.
To change a service’s name, change it in every place of the table above. To add a service, see Adding a service, a project or a job opening.
The plans
Section titled “The plans”Every service page has a plan card with a Weekly / Monthly switch. What the visitor sees first (the weekly plan) is
written in the HTML: the list after “What’s Included:” (<ul data-pricing-features>), the price
(<span data-pricing-price>$1,200</span>) and the unit (<span data-pricing-unit>per week</span>). Both plans are also
written in the card’s data-plans attribute, which the switch reads:
<div data-pricing-card data-plans='[{"label":"Weekly","unit":"per week","price":"$1,200","features":["Weekly brand development and strategy sessions", …]},{"label":"Monthly","unit":"per month","price":"$4,200","features":["Everything in the Weekly Package", …]}]' …>Change both: the HTML for the first view, the list for the switch. Keep the list valid: the attribute is in single
quotes, so write an apostrophe inside it as ' (or the typographic ’), and a double quote inside a text as \".
The prices are text, so a currency is whatever you write. The switch’s labels (“Weekly”, “Monthly”) are written twice
each in its buttons. “Book an intro call” leads to Contact.
The process chart
Section titled “The process chart”“Crafting Success, Step by Step” on the Services page draws the five phases of a project as bars that fill in when the
chart comes into view. The chart is drawn as two rows; every phase is in both rows with its share of the project
(data-phase-width="20%"), and data-phase-shown marks the row where its bar shows (Discovery, Execution and Reporting
in the first, Planning and Optimization in the second):
<div style="width: 0%; opacity: 0" data-phase-width="20%" data-phase-shown …> <p …>Discovery</p> <div class="h-6 w-full rounded-[50px] bg-silver"></div></div>To rename a phase or change its share, change it in both rows and in the list read by screen readers just before the
chart (<ul class="sr-only"><li>Discovery: 0–20%</li>…). The shares of the five phases add up to 100 %.
The testimonial slider
Section titled “The testimonial slider”“Hear From Customers” on the Services page shows the client quotes of the first three projects. It turns to the next one
every five seconds (data-interval="5"), waits while a keyboard user is on its chips, and the three chips under it
(portrait, name, role) choose a quote. The quotes are written in the data-testimonials attribute of the
<div data-testimonial-slider>, one entry per chip:
<div data-testimonial-slider data-interval="5" data-testimonials='[{"quote":"Working with this team…","caption":"Daniel Smith, CEO, EcoSolutions"}, …]'>The first quote is also written in the slider itself (data-slider-quote, data-slider-caption), so that it shows
before the script runs: change both. Each chip is a <button data-slider-chip> with the portrait, data-chip-name and
data-chip-role, in the same order as the list. Keep the list valid, as for the plans.
The team
Section titled “The team”About shows six team members, three per row on desktops (two on tablets): a photo, a Behance and an X button, the name
(<h3>) and the role. Each member is an <li> in the <ul data-team-list>; on desktops the others dim while the
pointer is on one. To add a member, copy an <li>, change the photo, the links, the name and the role. “Open Positions”
under the team lists the first three job openings, as written: change them when you change the openings.
The About video
Section titled “The About video”The photo card on About (about-video.jpg with a Play button) opens a video in a window over the page. The demo plays
the Framer template’s own promotional film from YouTube: replace it with yours. The address is in the data-embed of
the <dialog data-video-dialog> in about.html:
<dialog data-video-dialog data-embed="https://www.youtube.com/embed/8AHPXm9Y6mI?iv_load_policy=3&rel=0&modestbranding=1&playsinline=1&autoplay=1&mute=1" data-title="Compose video" aria-label="Compose video" …>Replace 8AHPXm9Y6mI with your video’s id (the part after youtu.be/ or watch?v= in its address), and the name in
data-title and aria-label. A Vimeo video works too: use its embed address (https://player.vimeo.com/video/<id>).
The video starts muted (mute=1), which is what lets browsers play it by itself. Nothing is loaded from YouTube until
the visitor presses Play. Change the caption beside the card (“Discover how Compose transforms brands…”) and the photo.
Images
Section titled “Images”assets/images/ holds every photo. The easiest change is to replace a file with yours under the same name: every
page that shows it updates. The download ships with grey placeholders that state the size each image was designed for
(for example 2000 × 1333).
To use a new file instead, change the src: <img src="assets/images/my-photo.jpg" …>. In pages inside a folder
(services/…, projects/…, careers/…, blog/…), the path starts with ../: src="../assets/images/my-photo.jpg".
In 404.html it starts at the site’s root: src="/assets/images/…". The width and height on the <img> are the
photo’s own size: write your photo’s, so that the browser keeps its space while it loads.
Every photo sits in a fixed frame and is cropped to fill it (object-cover), so a photo of other proportions works, but
you lose the edges the frame cuts. Frames change shape between phone, tablet and desktop, so keep the subject away from
the edges. Use photos at least as large as the demo’s:
| Photos | Files | Demo size |
|---|---|---|
| Home “Who are we?” and About “WHO WE ARE?” | about-1.jpg, about-2.jpg |
1100 × 619, 1100 × 1375 |
| The quote band on Home | home-quotes.jpg |
2400 × 1594 |
| The video card on About | about-video.jpg |
2240 × 1654 |
| The team (About), shown at 7 : 9 | about-team-<name>.jpg |
720 × 785 |
| A service’s photo (Services card, its page, “Other Services”) | service-<slug>.jpg |
2200 wide (Branding and Strategy 2000 × 2500) |
| The call to action on Services (tall, it moves behind the text) | services-cta.jpg |
2400 × 3600 |
| A project’s cover (its cards at about 1.43 : 1, the Home ticker, its page’s title) | project-<slug>-cover.jpg |
2000 wide, 1121 to 1367 tall (Elevating Education 2400 × 1600) |
| A project’s main and final photos | project-<slug>-main.jpg, project-<slug>-image-3.jpg |
2000 wide |
| A project’s Image 01 and Image 02 | project-<slug>-image-1.jpg, -image-2.jpg |
1200 wide |
| A client’s portrait (a project’s testimonial, the Services slider) | testimonial-<name>.png |
150 × 150 (some 135 × 135) |
| A post’s cover (its card at 353 : 420, its page, Prev / Next) | post-<slug>.jpg |
2000 wide, 1333 to 3000 tall |
| The four faces beside the Home rating (42 px round) | home-hero-avatar-1.svg to -4.svg |
42 × 42 |
| The client logos on About | client-logo-<name>.svg |
30 px tall |
The project and post file names follow their page’s address, except the home décor project, whose photos are named
project-digital-strategy-for-a-leading-home-decor-brand-… (without the accent). Several files are used in more than
one place: about-1.jpg and about-2.jpg (Home and About), a service’s photo, a project’s cover and a post’s cover
(their cards and their page), a client’s portrait (the project page and the Services slider). Replacing such a file
changes every place; to show another photo in one of them, use a new file there.
Use .jpg for photos and keep files small; compress them with Squoosh or
TinyPNG. Write an alt text for every photo that carries meaning (the demo describes each one);
leave it empty (alt="", written alt in the files) for decorative ones, like the client portraits next to their names.
The client logos are samples: replace the six client-logo-*.svg files with your clients’ logos (with their permission)
and their alt texts (“Penta logo”), in all three copies of the ticker. The faces beside the rating are small SVG files
holding a photo; replace them with photos of your own clients, or remove the <img>s. logo.svg is the logo as a file
for use elsewhere (the pages draw it inline).
Pages link to each other as about.html, blog.html, blog/<slug>.html; from inside a folder, add ../
(../contact.html). Keep the .html: it’s what lets the site work from any host and from disk. 404.html is the
exception: its links start at the site’s root (/contact.html), because hosts show it at any address.
Links to other sites open in a new tab (target="_blank" rel="noopener noreferrer"): the booking link, the social
buttons and the footer’s social links. “Scroll to Explore” leads to the section marked id="start" on its page.
mailto: and tel: links open the visitor’s mail app or phone.
The figures and the rating
Section titled “The figures and the rating”The Home hero’s rating (“4.9 / 5.0”, five stars, “Trusted by 500+ Brands Globally”) and About’s figures (“260+ Campaigns
Launched”, “5x Client ROI”, “10M+ Total Audience Reach”, “98% Client Satisfaction”) are plain text: they don’t count up.
Each figure is written as its number and its suffix (<span>260</span><span>+</span>). Write your own, true figures.
Load More
Section titled “Load More”Projects and Blog show five cards on desktops, four on tablets and three on phones, then “Load More” shows as many again;
Careers shows four openings at every size. Every card is in the HTML, so search engines find them all. The first page
is written in the HTML as classes on each card’s <li>, and the sizes in the list’s data-page-sizes:
<div data-load-more data-page-sizes='{"base":3,"md":4,"lg":5}' …> <li class="md:list-item lg:list-item">…</li> <!-- 1st to 3rd: shown everywhere --> <li class="hidden md:list-item lg:list-item">…</li> <!-- 4th: tablets and desktops --> <li class="hidden md:hidden lg:list-item">…</li> <!-- 5th: desktops --> <li class="hidden md:hidden lg:hidden">…</li> <!-- 6th on: after "Load More" -->After adding, removing or moving a card, give the cards their classes by position again (on Careers: the first four
md:list-item lg:list-item, the others hidden md:hidden lg:hidden). If all the cards fit on the first page, hide the
button too: class="hidden md:hidden lg:hidden" on its <div data-load-more-box>.
Adding a post
Section titled “Adding a post”-
The page. Copy an existing one, e.g.
blog/the-role-of-prototyping-in-product-design.html→blog/finding-your-voice.html. Use lower-case words joined by-for the file name; it becomes the address. Edit:- the title (
<h1>), the date (<time datetime="2024-06-25">Jun 25, 2024</time>) and the category after “Posted in”; - the cover photo (
srcandalt); - the text: paragraphs
<p class="mt-5 first:mt-0">, headings<h2 class="… mt-10 first:mt-0">, lists<ul class="mt-8 first:mt-0">and<ol class="mt-8 first:mt-0">with their<li class="…">,<strong>for bold (copy them from the post; Editing without touching HTML lists them); - Prev and Next (the next older and the next newer post), and “More Blog” (the three newest other posts);
- the
<head>: title, description, canonical,og:url, and theog:andtwitter:titles and descriptions.
- the title (
-
Blog. Copy a card (
<li …>…</li>) inblog.html, paste it at the top, and edit its link, photo, date, title and excerpt; then put the Load More classes in order. -
Home, if it should be among the three cards of “Stay up to Date with the Latest News” (they are the newest three: drop the last one).
-
The other posts: Next on the post that was newest until now, and “More Blog” on every post (it shows the three newest).
-
The sitemap. Add a line to
sitemap.xml:<url><loc>https://yourdomain.com/blog/finding-your-voice.html</loc></url>
To remove a post, do the reverse: delete the page, its cards, the Prev / Next links to it and its line in
sitemap.xml. Search the folder for the file name to catch any link left behind.
Adding a service, a project or a job opening
Section titled “Adding a service, a project or a job opening”The same steps as a post, with their own lists:
- A service: copy a page in
services/and edit its name, summary, photo, “What We Offer”, “Key Benefits” and the plans. Add its card toservices.htmland to “Other Services” on the other service pages, a row on Home if it should be among the first six, a checkbox to the contact form (Forms), its name to the footer’s ticker in every page if you like, and a line tositemap.xml. - A project: copy a page in
projects/and edit its service links, title, summary, the photos (cover, main, Image 01, Image 02, final), the year, the company, “Overview”, “Process”, the testimonial and “Outcome”. Add its card toprojects.html(and put the Load More classes in order), to “More Projects” on the other project pages, to Home (the ticker shows the first four, the list the fourth to the eighth) if it belongs there, and a line tositemap.xml. - A job opening: copy a page in
careers/and edit its title, type (“Full Time”, “Part Time”, “Remote”, “Freelance”), “Key Responsibilities”, “Requirements”, “Perks and Benefits” and “How to Apply”. Add its card tocareers.html(and put the Load More classes in order), to “Open Positions” on About if it should be among the first three, and a line tositemap.xml.
Several demo job openings hold placeholders in square brackets ([relevant programming languages and technologies]):
search the folder for [ and rewrite them, or delete the openings you don’t have.
Adding a page
Section titled “Adding a page”- Copy a page close to what you want, e.g.
about.html→approach.html. - Replace the sections inside
<main>with the ones you want. Every section in the template is a block you can copy from its page (or fromstyle-guide.html) and paste between<main>and</main>. - Update the
<head>(title, description, canonical,og:url, and theog:andtwitter:titles and descriptions). - If you copied a page that is in the menu, the copy marks that page as the current one in its two menus (the bar for
tablets and desktops, and the phone menu): replace those two links with a copy of a link that isn’t current. A
current link carries
aria-current="page",style="background-color: #b3ff00"and adata-motionthat keeps the lime on hover; the others carrystyle="background-color: rgba(252, 252, 252, 0)"and turn#bfbfbfon hover. - Link to it: in the two menus, copy the
<a>of a neighbouring link and change itshrefand its text (written three times); or add it to one of the footer’s columns. Keep the menu short: five links fit the header bar on a tablet. The header and the footer are the same in every page of a folder apart from those current marks, so once one page is done, copy them into the others (pages in a folder write../before each link, and404.htmlwrites its links from the root,/approach.html). Add the page tositemap.xml.
Removing a page
Section titled “Removing a page”Delete the file, remove its links from the menus and the footer of every page and its line from sitemap.xml. Search
the folder for the file name to catch any link left behind: buttons link to pages too (“More about us” to About; “Our
Services”, “More Services” and “All Services” to Services; “Our Projects”, “See more projects” and “See our Works” to
Projects; “See all positions” to Careers; “Contact Us”, “Contact us”, “Get in touch”, “Drop us a line” and “Book an
intro call” to Contact).
The style guide
Section titled “The style guide”style-guide.html shows every component with its name, which is handy for copying a button or a card. It’s hidden from
search engines and linked from nowhere. Delete it before publishing if you don’t want it online; its sample forms never
send anything.