← Back to home

Portfolio Setup Guide

Everything you need to set up your page on wanna-hire.me and it-iz.me.

1. Create your it-iz-me repo

  • Create a new repository on GitHub
  • Name it exactly it-iz-me (lowercase, hyphen)
  • Make it public
  • Use the default branch main

2. Add main.json

Add a file named main.json in the root of your repo. Your page loads from:

https://raw.githubusercontent.com/YOUR_USERNAME/it-iz-me/main/main.json

3. Field reference

All top-level fields are required. Arrays can be empty [] if you prefer.

FieldRequiredDescription
imgYesURL of your profile image. Use a raw GitHub URL if hosting in your repo.
img_altYesAccessible description of the image (for screen readers).
heading_boldYesMain heading — typically your name or intro.
heading_lightYesSubheading — role, tagline, or continuation of the intro.
desc_1YesIntro line shown before the tech badges.
tech_stackYesArray of skills. Each entry: string (icon = label) or { iconName, visibleName }.
desc_2YesBody text — short bio or skills summary.
desc_3YesClosing line above the CTA buttons.
cta_buttonsYesArray of buttons. Each: { type, label, href, icon? }. icon is optional.
social_linksYesArray of social links. Each: { type, label, href }.

Optional subfields

  • cta_buttons[].iconIcon for each button. Omit for default (document icon for primary, send for secondary). Format: SI IconName or BI IconName.
  • tech_stack[]Can be empty array [] if you don't want tech badges. Each entry can be a plain string instead of { iconName, visibleName }.

4. Icons

Use SI IconName (Simple Icons) or BI IconName (Bootstrap Icons). Omit prefix → SI assumed. Dots in names use dot (e.g. SI Nextdotjs).

Browse: Simple Icons · Bootstrap Icons

5. Profile image

Upload your image to the repo root (or a subfolder) and use the raw URL:

https://raw.githubusercontent.com/YOUR_USERNAME/it-iz-me/main/avatar.png

6. Complete example (void)

A full main.json with dummy data for user "void":

{
  "img": "https://raw.githubusercontent.com/void/it-iz-me/main/avatar.png",
  "img_alt": "Void's profile photo",
  "heading_bold": "hi there, i'm void",
  "heading_light": ": a developer who builds in the dark.",
  "desc_1": "i build stuff with",
  "tech_stack": [
    {
      "iconName": "SI Typescript",
      "visibleName": "TypeScript"
    },
    {
      "iconName": "SI React",
      "visibleName": "React"
    },
    {
      "iconName": "SI Nextdotjs",
      "visibleName": "Next.js"
    },
    {
      "iconName": "SI Rust",
      "visibleName": "Rust"
    }
  ],
  "desc_2": "I craft clean interfaces and reliable systems. When I'm not coding, I'm probably exploring new tools or contributing to open source.",
  "desc_3": "Looking for a developer who ships? Let's talk — I'm open to interesting projects and collaborations.",
  "cta_buttons": [
    {
      "type": "primary",
      "label": "View Portfolio",
      "href": "https://void.dev",
      "icon": "SI FileText"
    },
    {
      "type": "secondary",
      "label": "Get in touch",
      "href": "mailto:void@example.com",
      "icon": "BI Send"
    }
  ],
  "social_links": [
    {
      "type": "SI Github",
      "label": "GitHub",
      "href": "https://github.com/void"
    },
    {
      "type": "SI x",
      "label": "X",
      "href": "https://x.com/void"
    },
    {
      "type": "SI Linkedin",
      "label": "LinkedIn",
      "href": "https://linkedin.com/in/void"
    }
  ]
}

7. Checklist

  • Repo named it-iz-me, public
  • Default branch is main
  • main.json in repo root
  • img is a full URL (raw GitHub if in repo)
  • Icons use SI / BI format

Your page: https://wanna-hire.me/YourGitHubUsername