Graphite
Graphite is for one person: a product designer, a developer, or someone who does both. The homepage opens on your portrait drawn in graphite pencil. Move the cursor across it and a small fluid simulation washes the drawing away to show the real photo underneath; when the cursor rests, the drawing comes back on its own. Your name moves across the bottom of the screen in very large type.
The homepage continues with a short statement, three services, your recent work as large rows with a preview that follows the cursor, a grid of side projects, your career path and an about section. Every full page load starts with Hello in eight languages, and moving between pages raises a dark curtain with the next page’s name.
| Property | Value |
|---|---|
| Tier | Pro ($59) |
| Category | Personal Portfolio |
| Fonts | Hanken Grotesk for everything, bundled locally |
| Palette | Hero gray (#999D9E), near-black (#1C1D20), white pages, one blue for the round action buttons |
| Motion | GSAP, Locomotive Scroll and Three.js: Hello loader, curtain transitions, fluid drawing-to-photo hero, name marquee, magnetic buttons, cursor previews on project rows, scroll reveals |
| Styles | Plain CSS in src/styles/global.css, no CSS framework |
| Content | Every string, project, article and form field in src/config/site.ts |
| Languages | English, with a template for adding more |
Included routes
Section titled “Included routes”/- drawing hero, intro, services, recent work, side projects, career path and about/work/and/work/[slug]/- all projects with type filters and a list or card view, and a case study per project/about/- a statement, the about section, the services and the career path/blog/and/blog/[slug]/- the blog with topic filters and three articles/contact/- a dark page with the numbered form, your contact details and your local time/privacy/
The production build generates 15 static pages, including the 404 page, plus sitemap.xml and robots.txt.
What makes Graphite different
Section titled “What makes Graphite different”- A hero people play with - the portrait is a pencil drawing until the cursor moves over it, then the photo shows through a fluid trail that fades back into the drawing.
- Your own drawing in a few minutes - the README has a ready prompt for ChatGPT, Gemini or any image model that turns your photo into the matching drawing.
- Motion between pages - a Hello loader on every full page load and a curtain with the next page’s name between pages.
- Case studies that look finished - role, stack, client and year, a round Live site button, the screenshot in a browser frame on the project’s colour, the story, a gallery and a large link to the next case.
Graphite-specific setup
Section titled “Graphite-specific setup”Set the site address
Section titled “Set the site address”Set url in src/config/site.ts to your public address, for example https://yourname.com, or set PUBLIC_SITE_URL when you build. Canonical URLs, the social image, the sitemap and the structured data use it.
Name, logo and location
Section titled “Name, logo and location”name is your full name, used in page titles and the structured data. logo holds the corner logo: prefix, first and last, so ”© Code by Mira” slides to ”© Mira Halden” on hover. location.lines is the text on the dark tab at the left of the hero, location.city the city, and location.timeZone the IANA time zone for the live clocks in the footer and on the contact page.
The hero portrait and its drawing
Section titled “The hero portrait and its drawing”The hero needs two images of exactly the same size and framing: your photo at hero.portrait and a graphite drawing of it at hero.sketch, both 1122 x 1402 pixels. Where the cursor moves, the drawing melts away and the photo shows through, so the two have to line up.
- Crop a head-and-shoulders photo on a plain background to 4:5 and save it as
public/images/hero-portrait.webp. A plain gray background, or one replaced with#999D9E, blends in best. - Open an AI image tool that can edit an uploaded photo, attach your photo and paste the prompt from the theme’s
README.md. Save the result at the same size aspublic/images/hero-sketch.webp. - Place the drawing over the photo at 50% opacity in any image editor. If the outlines double up, scale the drawing layer until the eyes, mouth, face and shoulders overlap, then export it again.
hero.role holds the two lines beside the arrow. Where WebGL is not available, or the visitor prefers reduced motion, the hero shows the photo.
The loader
Section titled “The loader”loader.words is the list of greetings that play on every full page load, and loader.enabled: false removes it. Links between pages use the curtain instead, so the loader does not repeat while someone browses.
Add a project
Section titled “Add a project”Add an entry to projects. Its slug creates /work/<slug>/, and the order of the list is the order on the site. Each project has a title, a kind such as "Product design · Web app" (the part before the · becomes the work page filter), a description, the stack, a tile colour behind its screenshot, an image, the client, year and role, an intro, sections with a title and text, and a gallery of images with alt text. link is the live address behind the round Live site button; leave it empty to hide the button.
work.homeCount sets how many projects the homepage shows. The labels for the filters, the list and card view, the case study columns and the next case link are in work.
Side projects and career path
Section titled “Side projects and career path”products.items is the side projects grid: each item has a name, two meta labels, a tile colour, an image and an href. Set products.enabled to false to hide the grid. path.items is the career list, each with a role, the company in at, the years in when and a short description.
Connect the contact form
Section titled “Connect the contact form”The contact form starts in demo mode: it checks what is typed and says plainly that nothing was sent. Choose a provider in contact.delivery:
delivery: defineDelivery({ provider: "formspree", formId: "YOUR_FORM_ID" }),// or { provider: "formsubmit", recipient: "you@example.com" }// or { provider: "netlify", formName: "contact" }// or { provider: "custom", endpoint: "/api/contact", encoding: "json" }Everything in this config is sent to the browser, so never put a secret key in it. Update the privacy page for your provider. Netlify detects forms when it builds the site, so deploy again after switching to it.
Change the form fields
Section titled “Change the form fields”contact.fields lists the fields in the order they appear, each with a number beside it. Each has a name, a label, a type (text, email, tel, url, select or textarea), and optional required, placeholder, autocomplete, maxLength, rows, fullWidth and options settings. The name is what your provider receives. Every status message is in contact too.
Add an article
Section titled “Add an article”Add an entry to journal.posts. Its slug creates /blog/<slug>/. Each article has a title, a category (used by the blog filters), a date in YYYY-MM-DD, a description, a cover image with alt text, an introduction and sections, each with a title and text. The reading time is counted from the text.
Add a language
Section titled “Add a language”- Copy
src/i18n/locales/template.tsto a new file, for examplefr.ts, and translate what you need. - Import it and register it in
src/i18n/config.ts:import { translation as fr } from "./locales/fr";and addfrtolocales. - Run
npm run checkandnpm run build.
Every page then also exists under /fr/, the footer shows a language switcher and search engines get hreflang links. Anything you leave out falls back to English. Lists such as projects and articles replace the English list as a whole, so copy every item before translating. Keep slugs the same in every language. Set direction: "rtl" for right-to-left languages.
Search settings
Section titled “Search settings”description is the homepage description, and every other page takes its title and description from its own content. metadata.image is the social image, metadata.themeColor the browser colour. With structuredData.enabled, every indexable page carries JSON-LD: Person and WebSite everywhere, CreativeWork on case studies and BlogPosting on articles. Add your real profile links to structuredData.sameAs, and replace the # links in socials.
Tune the motion
Section titled “Tune the motion”The animation lives in src/scripts/main.js and the hero effect in src/scripts/hero-fluid.js. Visitors who prefer reduced motion get no loader, no page curtain, no fluid hero and no marquee.
The footer credit
Section titled “The footer credit”labels.credit in site.ts holds the “Created by aerolaunch.app” line in the footer. Edit it, or remove it from src/components/Footer.astro.