This workshop is about getting something online quickly, cheaply, and in a way students can understand. We treat a website as two problems:
Cheap and dirty websites use tools you already have — Google Docs and a free GitHub account — to solve both problems with as little friction as possible.
Fastest route, minimal control. Good for class notes, instructions, and zine-like documents that don’t need custom layout.
Pros: extremely easy, hosting is handled by Google, good for quick workshop outputs.
Cons: limited format control, Google headers/footers, hard to customize the look.
Simple but more control. Good when you want a small “real website” that behaves like a static page and can be edited later.
.zip, find the .html file, and rename it to something like index.html.The exported HTML is messy under the hood, but it works and can be tweaked later.
cheap-website-demo).index.html exported from the Google Doc.main and save.
GitHub will give you a URL of the form username.github.io. Your page will be visible at:
username.github.io/your-repository-name/index.html (or whatever file name you used).
Example: jonathaniscarroll.github.io/test-website/01-main.html
For interactive content (chatroom, archives, spreadsheet-driven sites), you can turn a Google Doc or Sheet into a web app using Apps Script. This is more technical, but powerful.
Index and paste your website code into it.Code file, add:function doGet(){ return HtmlService.createHtmlOutputFromFile('Index'); }
Pros: interactive content, hosting covered by Google.
Cons: more technical, single-page feel, URLs are cumbersome.
A finished Twine story is just one HTML file plus the image files it points to, so it is already a cheap and dirty website. The easiest route is Route 2 above, with a Twine story in place of the Google Doc export. A second route, itch.io, is described further down.
1. Publish from Twine. In Twine, open your story and choose Build → Publish to File. You get one playable .html file.
2. Name it. Rename the file to index.html so the site address does not need a file name on the end.
3. Gather the images. Keep your character frames and backgrounds in an images folder beside index.html. The paths in your story (for example images/char-idle-1.png) must match the folder exactly, including capital letters.
4. Upload both. In your GitHub repository choose Code → Upload files, drag in index.html and the whole images folder, and click Commit changes.
5. Switch on Pages. Go to Settings → Pages, choose main under Branch, and save.
6. Test and share. After a minute or two the game is at username.github.io/your-repository-name/. Open it on a phone, then turn the address into a QR code and put it on the page or print it.
Char-Idle-1.png is not char-idle-1.png), and the story uses relative paths such as images/... rather than a path on your own computer.
Not as a straightforward host. Google Drive does not serve a folder of files as a website, so a Drive link to your Twine file will show code or offer a download rather than run the game. There are two partial options:
Index file and deploy it. This can work for a story with no images, or with images embedded in the story or hosted elsewhere. Apps Script runs pages inside a frame, so test the game before relying on it in class.For the workshop, teach GitHub Pages as the main route and treat Apps Script as the optional “stay inside Google” route.
itch.io is a free home for games and interactive art. It runs HTML projects directly in the browser on a project page of their own, with a cover image, description and screenshots, and it recognises Twine stories automatically. Use it when you want a Twine game to look like a published work, and to be found by people who play interactive fiction. The same steps work for any small HTML, CSS and JavaScript project, such as a page you made in Route 2.
index.html, with an images folder beside it if the story uses pictures. For the Twine class, that is Step 11 of Making a Game in Twine (v2).| Your project | What to upload |
|---|---|
One .html file with no separate pictures (text-only Twine, or pictures embedded in the file) | The .html file itself, unzipped. It cannot refer to any other file you upload. |
An index.html plus an images folder, sound or other files | A ZIP file. A ZIP is the only archive type itch.io accepts; .rar, .7z and .tar.gz do not work, and uploading files one at a time does not work either. |
1. Name the entry file. The ZIP must contain a file called index.html. That is what players see first.
2. Use relative paths. Write images/nora-happy.png, never /images/nora-happy.png or a path on your own computer. A path starting with a slash points outside your project on itch.io and fails.
3. Match capitals exactly. itch.io’s server is case-sensitive, so a file called Hello.png will not load as hello.png. A project that works on your Mac or Windows computer can fail after upload for this reason alone.
4. Load other things over HTTPS. If the project fetches anything from another website, that address must start with https://.
index.html and the images folder.index.html at the top level of the ZIP, where itch.io looks for it.my-twine-game.zip.index.html straight away, without opening another folder first.1. Start a new project. Log in, open your dashboard from the menu in the top right, and choose Create new project.
2. Fill in the basics. Enter a title, check the project URL (it becomes yourname.itch.io/your-title), and write a short description that appears when the game is shared.
3. Set the kind. Under Kind of project, choose HTML.
4. Upload the file. Under Uploads, choose Upload files and select your ZIP (or your single .html). When it has finished, tick This file will be played in the browser.
After you upload a playable file, an Embed options section appears. These settings decide how the game sits on the page.
| Option | What to choose for a Twine game |
|---|---|
| Launch mode | Click to launch in fullscreen is the easiest choice, since the game then fits any screen and you do not have to give sizes. Or choose Embed in page and enter a viewport size, for example 960 × 640 pixels. |
| Click to Play | Leave it on. The game starts when the player clicks, which keeps the page quick to open. |
| Fullscreen button | Tick it if you used Embed in page. |
| Scrollbars | Tick it if a passage can run longer than the viewport. They are hidden by default, so a long passage could otherwise be cut off. |
| Mobile Friendly | Tick it once you have checked the game in a phone browser. On phones itch.io then always uses fullscreen launch. |
A Twine story with a background picture and a character picture, like the class story, adapts to any size, so fullscreen launch is the safest option.
twine and interactive-fiction so people can find the game.ERR_ABORTED 403 means a file name, capital letter or folder path does not match.Make the fixes, build a new ZIP, open the project’s Edit project page, and upload it. Delete the old file once the new one is in place, and tick the browser-play box on the new file. The page address stays the same.
| Problem | Likely cause and fix |
|---|---|
| Nothing to play, or only a download link | The kind is not HTML, or the box This file will be played in the browser is not ticked. |
| Blank page or “index.html not found” | index.html is not at the top level of the ZIP. Zip the contents of the folder, not the folder. |
| Works on your computer, pictures missing on itch.io | Capital letters differ from the file names, or the path starts with /. Use exact names and paths such as images/nora-happy.png. |
Console shows 403 | The request points to a folder, or to a file that is not in the ZIP. Check each path. |
| Text is cut off | Turn on Scrollbars in the embed options, or use fullscreen launch. |
| Wrong or old version shows | The old ZIP is still attached. Delete it, upload the new one, and reload the page. |
| Upload refused | The file is not a ZIP (for example .rar), or it breaks the limits above. |
itch.io’s own guide is at itch.io/docs/creators/html5. Menu names may change over time, so look for the same word if one has moved.
Whether you use a published Google Doc, a GitHub Pages URL or an itch.io page, QR codes make sharing easier in the room:
The original Cheap and Dirty Websites workbook lives here:
In the full session, Cheap and Dirty Websites comes second: