Editing the site — Marai Neesu HTML
Every page of Marai Neesu is a plain HTML file that you edit in a code editor. This guide shows where everything is, and how to add a project, a product, a post 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 forms 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, cv.html, contact.html, blog.htmlproject.html the Projects page (every project as a card)service.html the Services page (the four services and the FAQ)course.html the Course pageproduct.html the Products page (every product as a card)404.html shown for addresses that don't existstyle-guide.html every component with its name (noindex; delete it if you don't want it)project/*.html one page per projectproduct/*.html one page per productblog/*.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, the avatar, the tool, social and client logosassets/fonts/ Manropeicon.png, apple-icon.png, opengraph-image.pngsitemap.xml, robots.txtsrc/css/style.css the stylesheet's source: colours, breakpoints, fontPages 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-[22px] md:text-[24px] lg:text-[26px] leading-[1.2] font-medium">My latest work</h2>Change My latest work, leave the class. Ampersands are written & (Latest Articles & Publications), and
apostrophes are written either as the typographic ’ (Hey, I’m Marai Neesu) or as ' (Let's work together);
typing ' works too, & should stay &. When you search for a sentence, search for a part without them.
Button labels are written once, in mixed case; the button style shows them in capitals (More About me reads “MORE
ABOUT ME”). A few labels are written twice so that they can move:
-
The e-mail on Home rolls up to an orange copy under the pointer. It is written three times: once to size the link (
class="opacity-0", the copy screen readers read) and twice in the copy that rolls (aria-hidden="true"). Change all three, and themailto:address. -
The roles under the name (“Product Designer”, “Web Designer”, “Solopreneur”, “Digital Creator”) roll every four seconds on Home and on the CV. They are written in a list for screen readers (
class="sr-only") and again in the column that rolls (data-word-roll-column), where the first role is repeated at the end so that the roll loops without a jump:<div class="relative overflow-hidden w-[200px]" style="height: 20px" data-word-roll="4" data-word-roll-step="30"><ul class="sr-only"><li>Product Designer</li><li>Web Designer</li>…</ul><div aria-hidden="true" … data-word-roll-column><span …>Product Designer</span><span …>Web Designer</span>…<span …>Product Designer</span></div></div>Change both lists, and keep the first role at the end of the second.
data-word-rollis the pause in seconds;data-word-roll-stepis the height of one role plus the gap (20 + 10 px); thew-[200px]box must fit the longest role.
Text that repeats on every page
Section titled “Text that repeats on every page”The header, the footer, your links and your e-mail are copied into many pages. 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://marai-neesu-html-marcframe.vercel.app |
Your domain, e.g. https://www.yourname.com (canonical links, share cards, sitemap.xml, robots.txt) |
hello@example.com |
Your e-mail: the footer of every page, the Home hero, “Can’t decide or custom request?” on Home and Services and the FAQ’s “Email me” (the mailto: links and the text) |
Marai Neesu |
Your name: the logo of every page, the Home hero, the CV, the page titles and the share tags. Search for Neesu too: the copy of Home, About and the testimonials says “Neesu” alone |
Dubai, UAE |
Your place: under the name in the logo of every page, and in the Home title |
https://dribbble.com/, https://behance.net/, https://instagram.com, https://twitter.com, https://discord.com/, https://calendly.com/ |
Your profiles: the footer’s links, and Dribbble and Behance among the social tiles on Home |
https://facebook.com/, https://twitter.com/ |
The other two social tiles on Home (social tiles) |
https://marcframe.com |
The footer’s “Marcframe templates” link (replace it with a link of your own, or delete its <li>) and the credit “Template by Marcframe” |
| Marai Neesu in <title> and share tags |
| Your Name (the Home title, Marai Neesu - Personal Portfolio Website, has no suffix) |
content="Marai Neesu" |
Your site’s name (application-name and og:site_name) |
Marai Neesu — personal portfolio website template |
A description of your share image (og:image:alt) |
Include the .html, .xml and .txt files. Review each change before replacing all: the name also appears in the copy
of About, the CV, the testimonials and the products, which you may want to rewrite rather than replace.
The footer’s lines (“Have a project in mind?”, “Let’s work together, I’m open for part time / freelance”) are copy too. “Template by Marcframe” at the bottom of the footer is a credit you may keep or remove.
The footer clock and the year
Section titled “The footer clock and the year”The footer’s third column is headed by a city and its time, “Dubai - 4:05 PM”, which the script keeps current:
<span>Dubai</span><span aria-hidden="true">-</span><span class="…" data-local-time="Asia/Dubai"></span>Change Dubai to your city and Asia/Dubai to your time zone, in every page (find and replace in files). The value is a
name from the time zone database (Europe/London,
America/New_York). The time is empty until the script runs.
The year after “©” updates itself too (<span data-current-year>): leave the span in place.
Parts that repeat on several pages
Section titled “Parts that repeat on several pages”Some blocks are copied into several pages. Change them in every copy (find and replace in files works for text):
| Block | Pages |
|---|---|
| Header and footer | Every page |
| A project card (photo, title, summary, service, date) | index.html (the first four), project.html (all six), “See more projects” on the project pages |
| A project’s line on the CV (date, title, client, summary) | cv.html (the first four) |
| A service card | index.html and service.html (all four) |
| “Can’t decide or custom request?” | index.html, service.html |
| A product card (photo, title, tagline, price, “View Details”, the cart button) | index.html (six), product.html (all six), “More Products” on the product pages |
| A post card (photo, category, date, title) | index.html (the first three), blog.html (all twelve), “See more posts” on the posts, cv.html (“Writing”, the first four) |
| An experience (title, company, period, text) | about.html (all four), cv.html (“Work Experience”) |
| The FAQ (“Questions? Answers”) | service.html and course.html, each with its own questions |
| The course | course.html, and its banner on Home (“Become a Framer Hero in a week.”) |
The testimonials
Section titled “The testimonials”“Trusted by Professionals” on Home shows eight client quotes, each a card with the client’s portrait, name, role, five stars and the quote. From tablets up they move left in a row that never ends; on phones they are a slideshow with two arrows that steps every four seconds. So each card is written five times:
- three times in the moving row (
data-ticker-copy="0","1"and"2"), so that it loops without a gap; - twice in the slideshow (
data-card-slideshow="8"): the eight cards, then the same eight again in<li aria-hidden="true">.
When you change a testimonial, search index.html for the client’s name to find every copy. To add one, add its card to
each of the five lists (in the same place), and raise data-card-slideshow to the new number of cards. To remove one, do
the reverse.
The stars are five star icons in <p role="img" aria-label="Rated 5 out of 5">. For four stars, delete one <svg> and
change the label. Portraits are testimonial-<name>.jpg (images).
The social tiles
Section titled “The social tiles”The four small tiles beside “Social Profile:” in the Home hero show two letters (FB, TW, DB, BE); under the
pointer the tile shows the network’s logo (assets/images/social-*.svg) and the others fade. Each tile is one link:
<a href="https://facebook.com/" target="_blank" rel="noopener noreferrer" aria-label="Facebook" … data-social-tile> <span … data-social-face><span aria-hidden="true" …>FB</span></span> <img src="assets/images/social-facebook.svg" alt width="26" height="26" … hidden /></a>Change the href, the aria-label, the two letters and the logo file. Keep hidden on the <img>: the script shows it.
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 1440 × 1080).
To use a new file instead, change the src: <img src="assets/images/my-photo.jpg" …>. In pages inside a folder
(project/…, product/…, 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 that follow the screen 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 |
|---|---|---|
| The portrait of the Home hero | home-portrait.jpg |
600 × 830 (shown 150 × 200) |
| The avatar in the logo and on the CV | avatar.png |
180 × 180 (shown round) |
| The three photos of About | about-portrait.jpg, about-detail.jpg, about-wide.jpg |
1100 × 1573, 800 × 1200, 1100 × 1438 |
| A project’s cover (its card and the top of its page) | project-<name>-cover.jpg |
1440 × 1080 (4 : 3) |
| A project’s gallery (three screens) | project-<name>-gallery-1.jpg to -3.jpg |
1440 × 1080 for the first two, 2240 × 1680 for the wide third |
| A product’s cover and two screenshots | product-<slug>-cover.jpg, product-<slug>-screen-1.jpg, -2.jpg |
1200 × 814 |
| A post’s photo (its card and the cover of its page) | post-<words of its title>.jpg |
1600 px wide, landscape or portrait (the cover is cropped wide) |
| A service’s photos (four, rolling in the card) | service-product-1.jpg, service-web-…, service-mobile-…, service-ux-… |
400 px wide (shown 100 px wide) |
| The course’s cover and its banner on Home | course-cover.jpg, home-course.jpg |
2240 × 1260, 640 × 360 |
| The newsletter’s photo (Blog) | blog-newsletter.jpg |
1200 × 675 |
| Portraits of the testimonials | testimonial-<name>.jpg |
150 × 150 (shown round, 50 px) |
Several files are used in more than one place: a project’s cover (its cards and its page), a product’s cover, a post’s
photo (its cards and its page), avatar.png. Replacing such a file changes every place; to show another photo in one
of them, use a new file there.
The tool logos of About’s Stack (tool-*.png, tool-unsplash.svg, 100 × 100, shown 50 px with rounded corners) and
the social logos (social-*.svg) are logos, not photos: replace them with the tools and networks you use.
Use .jpg for photos and keep files small; compress them with Squoosh or
TinyPNG. Write an alt text for images that carry meaning; leave it empty for decorative ones
(written alt or alt=""). The demo describes every photo (alt="A koala asleep against a tree"): describe yours.
Client logos
Section titled “Client logos”“My Awesome Clients” on the Projects page moves five sample logos to the left, assets/images/client-*.svg, 25 px tall
at their own width. Replace the files with your clients’ logos (or change the src, for a PNG), the alt with each
client’s name, and the width and height with the logo’s size at 25 px tall (width="114" height="25"). The row is
written three times inside the ticker (data-ticker-copy="0", "1" and "2") so that it loops without a gap: make the
same change in all three. The sample logos are drawn in a mid grey.
To drop the strip, delete its <section> in project.html (the one that holds “My Awesome Clients”) and the divider
above it (<div aria-hidden="true" …> with a 1 px line).
Links to other sites
Section titled “Links to other sites”The demo points these at sample addresses; give each its real one:
| Link | Where | Demo address |
|---|---|---|
| “More Details” of each service card | index.html, service.html; also the service named at the top of each project page |
https://contra.com/ |
| “Live Demo” and “Buy - $59” on a product page, the cart button of every product card | product/*.html, product.html, index.html |
https://example.com |
| “Free Preview” of the first two lessons, “Enroll Today” | course.html |
https://www.youtube.com/, https://www.podia.com/ |
| The CV’s contact rows (My Website, My Dribbble, My Twitter), its education, work experience and certifications | cv.html |
https://example.com, https://dribbble.com, https://www.linkedin.com/, https://www.coursera.org/, … |
| The Stack’s tools | about.html |
each tool’s own site |
Links to other sites open in a new tab (target="_blank" rel="noopener noreferrer"); mailto: links open the visitor’s
mail app.
Pages link to each other as about.html, project.html, project/<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.
Lists that change with the screen
Section titled “Lists that change with the screen”A few lists hold more cards than they show on smaller screens. The cards are in the HTML; classes on their <li> hide
them: max-md:hidden on phones, md:max-lg:hidden on tablets, lg:hidden on desktops.
- Products Spotlight on Home: six products on desktops, four on tablets, three on phones.
- Latest Articles & Publications on Home and “See more posts” on a post: three posts, two on tablets.
- More Products on a product page: three products on desktops and phones, four on tablets.
When you add or move a card, copy the classes of the card whose place it takes.
The Blog’s “Load More”
Section titled “The Blog’s “Load More””The Blog holds all twelve posts in the HTML and shows six. The others are <li class="flex hidden" data-load-more-item>;
“Load More” shows them all at once and then disappears. Search engines find every post. To show every post without the
button, remove hidden from those items and delete the <button … data-load-more>.
The list keeps the order of the HTML, not the dates: the demo lists the newest post first.
The FAQ and the course modules
Section titled “The FAQ and the course modules”- The FAQ (“Questions? Answers”, on Services and Course) is a list of rows that open and close on their own; the
first is open when the page loads. Each question is a
<button aria-expanded="…" aria-controls="faq-<n>">and its answer a<div id="faq-<n>" role="region" aria-label="<the question>">. An open row hasaria-expanded="true", its answerstyle="visibility: visible; height: auto"withoutaria-hidden, the minus icon (data-open-icon) shown and the plus (data-closed-icon)hidden; a closed row the reverse. To add a question, copy a closed row, give its button’saria-controlsand its answer’sida new number (faq-8), and write the question in thearia-labeltoo. - The course modules (“What Will You Learn?” on Course) work the same way, with
data-module-buttonandid="course-module-<n>"; Module 01 is open when the page loads. Each lesson is a numbered row; the first two carry a “Free Preview” link.
Adding a project
Section titled “Adding a project”A project is a page plus its cards in the lists:
-
The page. Copy an existing one, e.g.
project/goeboek-real-estate-and-property.html→project/my-project.html. Use lower-case words joined by-for the file name; it becomes the address. Edit:- the service at the top (its text and link), the title, the summary, and the facts beside them: Client, Service and Date;
- the cover (
project-<name>-cover.jpg); - “Project Overview”: the paragraphs and the first two gallery screens; “Key Highlights”: the bulleted points
(each starts with a bold label,
<strong class="font-bold">…:</strong>) and the third, wide screen. A project without screens can leave the gallery out, asproject/makadam-creative-portfolio-website.htmldoes; - “See more projects”: two other projects (the demo shows the first two of the list that aren’t this one);
- the
<head>: title, description, canonical andog:url.
-
Projects. Copy a card (
<li class="flex">…</li>) inproject.html, paste it where the project belongs, and edit its link, photo, title, summary, service and date (the<time datetime="2024-06">and its text). -
Home and the CV, if it should be among the first four (“My latest work” and the CV’s “Project”).
-
The sitemap. Add a line to
sitemap.xml:<url><loc>https://yourdomain.com/project/my-project.html</loc></url>
Adding a product
Section titled “Adding a product”- The page. Copy a page in
product/, e.g.product/wedoes.html→product/my-product.html. Edit the name and tagline, the description under them, the price on the “Buy” button, the links of “Live Demo” and “Buy” (links), the cover and two screenshots, the “Overview” text (paragraphs, headings and bulleted lists, as on the page), “More Products” and the<head>. The demo’s titles are “Name - Tagline”, without the “| Marai Neesu” suffix because they would pass 60 characters with it. - Products. Copy a card in
product.htmland edit its two links (the photo and “View Details” open the product’s page, the cart button the shop), itsaria-label(Buy <name>), photo, title, tagline and price. - Home and “More Products” on the other product pages, where it should appear (lists that change with the screen).
- The sitemap. Add its line to
sitemap.xml.
Adding a post
Section titled “Adding a post”-
The page. Copy a page in
blog/, e.g.blog/the-role-of-prototyping-in-product-design.html→blog/my-new-post.html. Edit the breadcrumb’s last item, the title, the photo, the date (the<time>element’sdatetimeand its text,Jul 8, 2024) and the category on the cover, the text, “See more posts”, and the<head>, with the post’s date inarticle:published_time.The text is plain HTML inside the
lg:max-w-[900px]block. Copy the elements from the page: paragraphs are<p class="first:mt-0 mt-5">, headings<h3 class="… first:mt-0 mt-10">, lists<ul class="pl-[2ch] … [list-style-type:disc] …">or<ol … [list-style-type:decimal] …>with a<p class="first:mt-0">in each<li>.<strong class="font-bold">sets words in bold and<code class="font-[inherit]">marks a piece of code (max-width: 100%) in the text’s own font.“See more posts” lists up to three other posts of the same category (Product Design, Web Design or UX/UI in the demo). Leave the section and the divider above it out when there are none.
-
The Blog. Add its card to the list of
blog.html: at the top for a newest post. Keep six cards visible andhiddenwithdata-load-more-itemon the others (Load More). -
Home and the CV show the first three and the first four posts: change the cards there if the new post should appear, and “See more posts” on the posts of the same category.
-
The sitemap. Add a line with the post’s date:
<url><loc>https://yourdomain.com/blog/my-new-post.html</loc><lastmod>2026-10-13</lastmod></url>
To remove a project, a product or a post, do the reverse: delete the page, its cards, any link to it and its line in
sitemap.xml. Search the folder for the file name to catch any link left behind.
Services, experiences, tools and the course
Section titled “Services, experiences, tools and the course”- A service has no page of its own: its card on Home and Services holds the title, the price (“Starting at $3,000 per project”), the text, “More Details” and four photos that roll in two columns (tablets and desktops) or a row (phones). The photos are written several times in the card, once per column and copy: replace the files to change them all. Its name is also a choice of the contact form (Forms) and the service of the projects that name it.
- An experience is a card on About and a line on the CV (“Work Experience”): change both.
- A tool of the Stack (About) is a link with the logo, the name and its category.
- The course is all in
course.html: the label, the title, the subtitle, the cover, “About Course”, the modules, “Key Learning Outcomes”, the overview card with its list, the price and “Enroll Today”, and its FAQ. Its banner on Home repeats the title, a line and the cover’s smaller copy (home-course.jpg).
Adding a page
Section titled “Adding a page”- Copy a page close to what you want, e.g.
about.html→awards.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>.<main>makes room for the fixed header by itself (pt-[74px] md:pt-[84px] lg:pt-[92px]), so the first section needs no extra space. A divider is<div aria-hidden="true" …>holding a 1 px line: copy one from the page. - Update the
<head>(title, description, canonical,og:url, and theog:andtwitter:titles and descriptions). - The copy marks the page you copied as the current one: in the header (the bar for tablets and desktops, and the phone
menu) its link is a black pill with
aria-current="page",data-hover="off"andbg-black text-background. Replace that<a>with a copy of a neighbouring link (with itshrefand text changed back), and update the breadcrumb, if the page has one. - Link to it: in the phone menu, copy the
<li>of a neighbouring link and change itshrefand its text; the bar for tablets and desktops holds four links (Home, Portfolio, About, Service), so check a fifth fits on a tablet. Or add it to a column of the footer. The header and the footer are the same in every page of a folder apart from thosearia-currentmarks, so once one page is done, copy them into the others (pages inproject/,product/andblog/write../before each link, and404.htmlwrites its links from the root,/awards.html). Add the page tositemap.xml.
Removing a page
Section titled “Removing a page”Delete the file, remove its links from the header 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 (“All works” to Projects, “All
products” to Products, “All articles” to the Blog, “Learn Now” to Course, “View my Cv” to the CV, “Contact Me” to
Contact). The Go Back pill of the project, product and post pages falls back to their list page.
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.