Skip to content
Sign inJoin waitlist

Editing the site — Brickfolio HTML

Every page of Brickfolio’s HTML edition is a plain file you edit in a code editor: where everything is, and how to change Home’s sections, add a project or a post, or add a page.

Double-click index.html: the site opens in your browser and every link between pages 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 Home: the profile card, every section, the footer
project/*.html one page per project (6)
blog/*.html one page per post (12)
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)
cv.pdf the CV behind "Download CV"
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 and client logos
assets/icons/ the social networks' marks shown over a hovered social link
assets/fonts/ Inter, Fragment Mono
icon.png, apple-icon.png
sitemap.xml, robots.txt
src/css/style.css the stylesheet's source: colours, breakpoints, fonts

Pages 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 project card’s title looks like this:

<h3 class="text-sm leading-[1.2] font-medium md:text-base lg:text-lg text-light">
EcoShop - Sustainable E-commerce Platform
</h3>

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 &amp; (Latest Articles &amp; Publications) and some apostrophes &#39; (Let&#39;s Connect); the demo also uses the typographic ’ (I’m). Typing ' and " in text works too; & should stay &amp;.

Dates are written twice: <time datetime="2024-07-08">Jul 8, 2024</time>. The datetime is the date in year-month-day form (a project’s is 2024-07, month only), for search engines; the text is what the visitor reads.

The header, the footer and the newsletter box 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://brickfolio-html-framebrick.vercel.app Your domain, e.g. https://www.yourname.com (canonical links, share cards, sitemap.xml, robots.txt)
>Brick< and >folio< The two lines of your name in the logo (Design)
aria-label="Brickfolio" Your name: the name of the logo link, for screen readers
Copyright © Brickfolio | Designed by Framebrick Your footer line (it is in the footer of every page, and in the profile card of index.html from 1440 px)
| Brickfolio</title> and | Brickfolio" in share tags | Your Name (Home’s title, Brickfolio - Personal Portfolio Website, has no suffix)
content="Brickfolio" Your site’s name (application-name and og:site_name)
Subscribe to Our Newsletter, Join now and never miss out on our stuff again. Because you are worth it! The newsletter box’s title and text
Hire Me The header’s button (it leads to the contact form)

Include the .html, .xml and .txt files. Review each change before replacing all.

Block Pages
Header, with the phone menu Every page (the 404’s links start at the site’s root, /index.html#…)
Footer: the newsletter box and the copyright line Every page but the 404
A project’s card “My Latest Work” on Home, and “More Projects” on the other project pages
A post’s card “Latest Articles & Publications” on Home, and “More Posts” on the other posts of its category

Search the folder for a project’s or a post’s file name (ecoshop-sustainable-e-commerce-platform) to find every card of it.

index.html holds every section of Home in order: the profile card, My Latest Work, Work with Me, “Can’t decide or custom request?”, Trusted by Professionals, My Experiences, My Awesome Clients, Latest Articles & Publications, Let’s Connect and Questions? Answers, then the footer. Each section’s title is written in two parts: the words and the accent word in bold italic (My Latest <span class="font-bold italic">Work</span>).

  • The profile card: the photo (profile-javier-martinez.png), the greeting, the roles, the headline (the page’s <h1>), the text and the four social links (each a two-letter chip such as FB, the network’s name in aria-label, and its mark from assets/icons/, shown on hover).
  • The roles under the greeting step up every four seconds. They are written three times: once in a line for screen readers (<span class="sr-only">Product Designer, Web Designer, …</span>), then one <li> per role, then the first role again as the last <li> (so the loop has no gap). The box carries data-count="4": the number of roles. Change all three when you change the roles.
  • The services: four cards, each with its title, description, “Starting at $3,000 per project”, “More Details” (to #contact) and two columns of small photos. Each column lists the four photos twice (so the loop has no gap), the first column in order and the second in reverse: replace a photo in all four places, or keep the file name.
  • The testimonials and the client logos are tickers: the list is written twice, the second copy with aria-hidden="true", and the box carries data-count (8 quotes, 5 logos) and data-speed (pixels per second). When you add, remove or change a quote or a logo, do it in both copies and set data-count to the new number.
  • “Download CV” links to cv.pdf: replace that file with your CV.
  • The contact form and the newsletter box are described in Forms.
  • The questions: each is a button and an answer; the first is open (aria-expanded="true") and the others closed. Copy a closed one to add a question, and keep its id and aria-controls pair unique.

“My Latest Work” and “Latest Articles & Publications” list every project and every post as cards, but show four at a time: the cards after the fourth carry the class hidden, and “More Projects” / “More Posts” removes it from four more per click (the box’s data-page-size="4"). When you add a card, keep the first four without hidden and every later one with it. With four cards or fewer, delete the button.

Posts are listed newest first, projects in the order you choose: put a new post at the top (and add hidden to the card that becomes fifth).

  1. The page. Copy an existing one, e.g. project/ecoshop-sustainable-e-commerce-platform.html → project/northwind-brand-refresh.html. Use lower-case words joined by - for the file name; it becomes the address. Edit:

    • the title (<h1>), Date (datetime and text), Service and Client, and the cover photo (src, alt, width and height);
    • the text under “Project Overview” and “Key Highlights” (the text of a project or a post);
    • the three gallery photos: two side by side, one full width (delete one you don’t need);
    • “More Projects”: three other projects’ cards (the third is hidden below 1000 px);
    • the <head>: title, description, canonical, og:url, the og: and twitter: titles and descriptions, the share image (og:image, twitter:image: the cover’s full address) and og:image:alt.
  2. Home. Copy a card in “My Latest Work” (an <li> with its link, cover, title, summary, service and date), paste it where it should show and edit its link, photo and texts (above).

  3. The other projects whose “More Projects” should show it.

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

    <url><loc>https://yourdomain.com/project/northwind-brand-refresh.html</loc></url>
  1. The page. Copy one in blog/ and rename it. Edit the title (<h1>), Date and Category, the cover, the text, “More Posts” (up to three other posts of the same category, newest first) and the <head> as for a project, plus article:published_time (the date).
  2. Home. Copy a card in “Latest Articles & Publications”, paste it at the top and edit it; add hidden to the card that becomes fifth.
  3. The posts of its category, whose “More Posts” should show it.
  4. The sitemap. Add a line to sitemap.xml.

To remove a project or a post, do the reverse: delete the page, its cards and its line in sitemap.xml. Search the folder for the file name to catch any link left behind.

The text sits in a <div> after the cover (a project has two: under “Project Overview” and “Key Highlights”), and uses a few tags. Copy them from a post:

Block HTML
Paragraph <p class="not-first:mt-5">
Heading <h3 class="text-xl leading-[1.2] font-medium md:text-[22px] lg:text-2xl not-first:mt-10">
Bulleted list <ul class="relative list-none not-first:mt-[15px]"> with <li class="relative before:absolute before:start-0 ps-[1.25em] before:content-['•']"><p>…</p></li>
Numbered list <ol …> with before:content-[counter(list-item)_'.'] on its items
More inside a list item further <p> and lists after the item’s first <p> (the demo’s numbered steps)
Bold <strong class="font-bold">
Code <code class="rounded-md bg-white/5 px-[0.2em] py-[0.1em] font-mono"> (Fragment Mono, loaded on the post pages)

The classes in the table are those of the demo’s posts; copy the real tag from a post rather than typing it, so that every class is one the stylesheet already has.

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 1600 × 1066).

To use a new file instead, change the src: <img src="assets/images/my-photo.jpg" …>. In pages inside a folder (project/…, 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. Use photos at least as large as the demo’s:

Photos Files Demo size
A project’s cover (its cards, the top of its page, its share image) project-<name>-cover.jpg 1600 × 1066
A project’s gallery project-<name>-1.jpg, -2.jpg (side by side), -3.jpg (full width) 1000 wide, 1600 wide
A post’s cover post-<first words of the slug>.jpg 1600 wide
A service’s small photos service-<slug>-1.jpg … -4.jpg 300 wide (200 to 375 tall)
A testimonial’s photo (50 px round) testimonial-<name>.jpg 70 to 150 px square
The profile photo (80 px round; also the logo’s) profile-javier-martinez.png 240 × 240
The client logos (30 px tall) client-logo-1.svg … SVG

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); the client logos say alt="Client logo": write your clients’ names.

icon.png and apple-icon.png in the root are the browser icons: the profile photo in a circle, placeholders in the download (Design).

Pages link to each other as index.html, project/<slug>.html, blog/<slug>.html; from inside a folder, add ../ (../index.html#contact). Keep the .html: it’s what lets the site work from any host and from disk. The links and images of 404.html start at the site’s root (/index.html), because it is shown at any address.

The header’s links lead to Home’s sections: index.html#project, #service, #resume, #blog and #contact are the ids of the sections. If you change a section’s id, change the links in every page. The social links lead to the networks’ home pages until you change them. The mailto: link (“Email me”) opens the visitor’s mail app.

  1. Copy a project page (it has the header, the column and the footer), e.g. to about.html in the root. Its links and images start with ../: remove that part (../index.html → index.html).
  2. Replace the blocks inside <main …> with the ones you want. Every block in the template can be copied from its page (or from style-guide.html) and pasted between <main …> and </main>. Delete the fixed close button at the end of the page if you don’t want it.
  3. Update the <head> (title, description, canonical, og:url, and the og: and twitter: titles and descriptions; remove the og:image tags or point them at a picture of the page).
  4. Link to it: in the header’s two menus (the row for tablets and up, and the phone menu), copy the <li> of a neighbouring link and change its href and its text. Keep data-close-menu on the phone menu’s links: it closes the menu when the link is pressed. Do it in every page. Add the page to sitemap.xml.

Delete the file, remove its links from the menus and the cards of every page, and its line from sitemap.xml. Search the folder for the file name to catch any link left behind.

style-guide.html shows every component with its name, which is handy for copying a card or a button. It’s hidden from search engines and linked from nowhere. Delete it before publishing if you don’t want it online.