# homemade jam!

a set of scaffolds for making your own self-hosted game (or otherwise creative) jam a la the ones on [itch.io](https://itch.io). like, for whatever reason.

right now, there are templates for plain HTML, plain PHP, [jekyll](https://jekyllrb.com), [hugo](https://gohugo.io), [astro](https://astro.build), [zola](https://getzola.org), and [wordpress](https://wordpress.org). i may just manifest others but also feel free to open an issue for some site-building method you use! it may just take some time to get around to learning that engine lmao

there is also a folder called "colorthemes" that has, well, a bunch of color themes to replace the site variables with if you want something different and don't feel inspired.

some notes for each version follow below; please make sure and read the section for whichever framework you're working with!

## plain html

please note that some of the javascript **WILL NOT WORK** unless you are running it on some kind of local web server (as opposed to just opening the html file in your browser). the reason for this is that it needs to send header data for some requests and just opening an html page locally doesn't do that, i guess. alternately just dropping them on neocities or something will make it work

if you don't have a local server solution already set up, you could probably use something like [simple web server](https://simplewebserver.org). it doesn't have a linux build, but i supsect if you're a linux person you can figure out how to set up a temporary simple web server with python (http.server) or node (http-server).

replace things in the template files that are surrounded by double exclamation points (!!). there are some variables to set at the top of the `js/script.mjs` file, and some style variables to set at the top of `css/style.css`. if you want to add more css, there's a `css/custom.css` file you can tack new stuff onto.

also, you will have to fiddle with JSON for game data. unless you want to just code all them manually for some reason, in which case i salute you. i recommend using [json console](https://jsonconsole.com/json-editor) if you're not down with the brackets since the table and graph views are really useful for like. checking your work

## plain php

if you're running php i'm presuming you know how to set up your own local web server for dev or have a box you can drop it onto.

## jekyll

watch this space

## astro

please note that there's a bun.lock file because i use [bun](https://bun.sh) but you do not have to. you can use npm/pnpm/yarn/deno etc it's daijoubu

## hugo

watch this space

## zola

watch this space

## wordpress

watch this space

## additional notes

### stuff this uses

* default favicon by [supanut piyakanont](https://thenounproject.com/creator/supanutpiyakanont/)
* filtering uses [advanced filtering system](https://misits.github.io/advanced-filter-system/) by misits
* fonts provided by [google fonts](https://fonts.google.com/) but if you want to move those assets local i recommend fontsquirrel's [webfont generator](https://www.fontsquirrel.com/tools/webfont-generator) to generate and optimize the font formats
* icons from [font awesome](https://fontawesome.com)