Skip to content
Sign inJoin waitlist

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.

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:

Terminal window
npx serve .

npm start runs the same command. Then edit the files in a code editor and reload the browser to see the change.

index.html, about.html, cv.html, contact.html, blog.html
project.html the Projects page (every project as a card)
service.html the Services page (the four services and the FAQ)
course.html the Course page
product.html the Products page (every product as a card)
404.html shown for addresses that don't exist
style-guide.html every component with its name (noindex; delete it if you don't want it)
project/*.html one page per project
product/*.html one page per product
blog/*.html one page per post
assets/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 endpoint
assets/images/ photos, the avatar, the tool, social and client logos
assets/fonts/ Manrope
icon.png, apple-icon.png, opengraph-image.png
sitemap.xml, robots.txt
src/css/style.css the stylesheet's source: colours, breakpoints, font

Pages 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 &amp; (Latest Articles &amp; Publications), and apostrophes are written either as the typographic ’ (Hey, I’m Marai Neesu) or as &#39; (Let&#39;s work together); typing ' works too, & should stay &amp;. 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 the mailto: 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-roll is the pause in seconds; data-word-roll-step is the height of one role plus the gap (20 + 10 px); the w-[200px] box must fit the longest role.

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’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.

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.”)

“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 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.

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.

“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).

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.

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 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 (“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 has aria-expanded="true", its answer style="visibility: visible; height: auto" without aria-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’s aria-controls and its answer’s id a new number (faq-8), and write the question in the aria-label too.
  • The course modules (“What Will You Learn?” on Course) work the same way, with data-module-button and id="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.

A project is a page plus its cards in the lists:

  1. 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, as project/makadam-creative-portfolio-website.html does;
    • “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 and og:url.
  2. Projects. Copy a card (<li class="flex">…</li>) in project.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).

  3. Home and the CV, if it should be among the first four (“My latest work” and the CV’s “Project”).

  4. The sitemap. Add a line to sitemap.xml:

    <url><loc>https://yourdomain.com/project/my-project.html</loc></url>
  1. 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.
  2. Products. Copy a card in product.html and edit its two links (the photo and “View Details” open the product’s page, the cart button the shop), its aria-label (Buy <name>), photo, title, tagline and price.
  3. Home and “More Products” on the other product pages, where it should appear (lists that change with the screen).
  4. The sitemap. Add its line to sitemap.xml.
  1. 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’s datetime and its text, Jul 8, 2024) and the category on the cover, the text, “See more posts”, and the <head>, with the post’s date in article: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.

  2. The Blog. Add its card to the list of blog.html: at the top for a newest post. Keep six cards visible and hidden with data-load-more-item on the others (Load More).

  3. 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.

  4. 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).
  1. Copy a page close to what you want, e.g. about.html → awards.html.
  2. 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 from style-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.
  3. Update the <head> (title, description, canonical, og:url, and the og: and twitter: titles and descriptions).
  4. 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" and bg-black text-background. Replace that <a> with a copy of a neighbouring link (with its href and text changed back), and update the breadcrumb, if the page has one.
  5. Link to it: in the phone menu, copy the <li> of a neighbouring link and change its href and 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 those aria-current marks, so once one page is done, copy them into the others (pages in project/, product/ and blog/ write ../ before each link, and 404.html writes its links from the root, /awards.html). Add the page to sitemap.xml.

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.

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.