This is a template for people who have no clue what they're doing. It uses Deploy to Neocities to allow you to edit your site on your desktop or anywhere else you can edit a Github repository.
- Make your own repository with this one as your template
- Name it something, I used my Neocities username
- Go to your project's Settings
- Look for the Security section on the left side
- Click
Secrets and variables - Click
Actions - Click the green button that says
New repository secret - Name it
NEOCITIES_API_TOKEN - Add your API token as the content of the secret (get it by going to https://neocities.org/settings/YOURUSERNAME#api_key)
- Upload your site's contents to your /public/ folder
Now, whenever you add or change something to your repository's "main" branch, it'll upload the changed stuff to your Neocities page!
Once it's working, if you want to be able to delete files on your site from your repository, go to your neocities.yml file at /.github/workflows/neocities.yml and change cleanup: false to cleanup: true.
Now you can edit your site through Github! You can use Github Desktop to edit it directly from your computer. If you want to use Node.js or any of that funky nonsense, check the Deploy to Neocities documentation. Remember to account for your default branch being named main or master.
If you need a working example, check my site's repository.