Remote Gig guides
Free HTML Portfolio Starter You Can Edit and Publish
A portfolio helps when a role asks for work samples. This starter is one accessible, mobile-friendly HTML file with made-up example details. You edit it in a text editor, check it yourself and decide whether to publish it. Nothing is collected from you or published for you.
What you can download
- portfolio-starter.html: the whole portfolio in one file. Use it for a single-page site.
- portfolio-starter.zip: the same page as
index.htmlat the top of a ZIP, plus the optional location example in anexamplesfolder. Use it for a site with more than one page. - location-selector-example.html: an optional project for developers, described below.
The files use no build tools, no frameworks, no web fonts and no tracking. They load nothing from other websites when you open them, and we send them exactly as written. If your browser shows one of the two single files as text instead of saving it, choose Save Page As and name the file portfolio-starter.html (or location-selector-example.html).
Edit it in six steps
- Open the file in any plain-text editor, such as Notepad, TextEdit in plain-text mode or VS Code.
- Search for
EDIT. The page has seven numbered markers that say what to change. - Replace every example detail: the name, role, projects, jobs, skills and links. Use only facts you can back up in an interview.
- Delete the yellow template notice and the
<meta name="robots">line near the top. The notice stops anyone publishing the fictional details by mistake. The robots line asks search engines to skip the page, so remove it once the page is yours if you want it to be found. - Open the file in your browser. Press Tab to move through the links with the keyboard, and narrow the window to the width of a phone.
- Click every link. Each example address points to a placeholder page, so a link left unchanged is a mistake to fix.
Before you publish
A published page is public. Leave out anything you would not hand to a stranger, such as a home address, a phone number you do not want called, an employer's confidential work or a customer's data. Use a contact address you are comfortable with. Test the finished page in a private window, signed out of everything.
Publish it on MakeMySiteLive
MakeMySiteLive is another product from our team. Its documentation describes two routes that fit these files. You choose whether to publish, and you can stay with the files on your own computer.
- One HTML file: create a free account, create a microsite in the dashboard and upload
portfolio-starter.htmlafter you have edited it. Its documentation lists a microsite as one.htmlor.htmfile of up to 3 MB. - A ZIP: create a full site in the dashboard, choose an available subdomain and drop in the ZIP. It needs
index.htmlat the root, or inside a single wrapping folder, which it detects. Our ZIP already has it at the root.
The address looks like yourname.makemysitelive.com. Its pages say that new free full sites can be hidden from Google for their first 7 days and that microsites are not listed in search, so share the link in your applications instead of waiting to be found. Plans, prices and limits change, so read its pricing page and terms before you publish. The terms rule out impersonation, so publish only your own work. These details come from its own pages as read on 14 November 2026.
Optional: a location selector for developers
If your project asks people for an address, a country, state and city selector is a small project you can explain well in an interview. The download above shows one that works on its own, with the keyboard, using a short sample list built into the file. That sample is not the full dataset. Its three loader functions are the only place that decides where the data comes from.
CountryStateCity is also our product. It offers two different things, and they are used differently:
- The hosted API. Requests go to
https://api.countrystatecity.in/v1. Every request needs a key in theX-CSCAPI-KEYheader, and its documentation says never to use a key in browser code. Keep the key on your own server or serverless function and let your page call that. The free plan has daily and monthly request limits, so cache the lists; see the pricing page for the current limits. - The downloadable dataset. Database files in several formats, including JSON and CSV, that you can ship with a project or load into your own database. It carries the ODbL-1.0 licence, so read the dataset page and its licence before you use it. Coverage varies by country and release.
The endpoints for the three lists are /countries, /countries/{country code}/states and /countries/{country code}/states/{state code}/cities. This is a minimal server-side helper; it reads the key from the environment and never writes it into a page:
// server.js: run on your own server, never in the browser
const BASE = 'https://api.countrystatecity.in/v1';
async function csc(path) {
const res = await fetch(BASE + path, { headers: { 'X-CSCAPI-KEY': process.env.CSC_API_KEY } });
if (!res.ok) throw new Error('CountryStateCity answered ' + res.status);
return res.json();
}
// csc('/countries') csc('/countries/IN/states') csc('/countries/IN/states/MH/cities')
Then change the three loader functions in the example to call your own server's addresses. See the CountryStateCity documentation for the fields each list returns.
What this does not do
A portfolio supports an application; it does not decide the outcome. We cannot promise interviews, offers or search ranking, and the template does not review your content. Go back to the application checklist before you send an application.