Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/theinfamouscoder5/codys-shack-games/llms.txt

Use this file to discover all available pages before exploring further.

Cody’s Shack Games is a fully static site — every page is plain HTML, CSS, and JavaScript. There is no build step, no server-side code, and no database to configure. You can host it anywhere that serves static files over HTTP or HTTPS, from free platforms like GitHub Pages and Netlify to a self-managed VPS running Nginx or Apache.
The official README notes that detailed deployment instructions have been intentionally omitted by the author to discourage people from presenting the site as their own original work. The steps documented here are provided for legitimate self-hosted instances. Please credit the original project appropriately.

Deployment Options

GitHub Pages

Free hosting directly from a GitHub repository — ideal for personal or school deployments.

Netlify

Drag-and-drop or connect your repo for automatic deploys on every push.

Vercel

Import your GitHub repo in the Vercel dashboard; set the framework preset to Other.

Any Web Server

Apache, Nginx, Caddy — point the document root at the project folder and you’re done.

GitHub Pages Walkthrough

1

Fork or upload the repository

Push the project files to a GitHub repository under your account. The repository can be public or private (GitHub Pages is available on both with the right plan).
2

Open repository Settings

Navigate to your repository on GitHub and click the Settings tab in the top navigation bar.
3

Enable GitHub Pages

Scroll down to the Pages section in the left sidebar. Under Source, select Deploy from a branch, then choose main (or whichever branch holds your files) and set the folder to / (root).
4

Save and wait for deployment

Click Save. GitHub will build and publish the site within a minute or two. The live URL will appear at the top of the Pages settings panel — typically https://<your-username>.github.io/<repo-name>/.

Netlify

Connect your GitHub repository in the Netlify dashboard and Netlify will auto-deploy on every push to main. Alternatively, drag and drop the entire project folder into the Netlify web UI at app.netlify.com for an instant one-off deploy — no account linking required.

Vercel

Import the GitHub repository from the Vercel dashboard at vercel.com/new. When prompted for a framework preset, select Other. Vercel will detect that no build command is needed and serve the static files directly.

Nginx Configuration

For self-managed servers, the following minimal Nginx server block is all you need. Replace yourdomain.com with your actual domain and /var/www/codys-shack with the path where you cloned or uploaded the project.
server {
    listen 80;
    server_name yourdomain.com;
    root /var/www/codys-shack;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }
}
After saving the config, reload Nginx with sudo nginx -s reload. For HTTPS, pair this block with a Certbot certificate.

Important: Do Not Open via file://

The site uses fetch() at runtime to load config/games.json and config/apps.json. Browsers block cross-origin fetch() requests when a page is opened directly from the filesystem using a file:// URL. Always serve the site over HTTP or HTTPS — even locally — to avoid CORS errors that will prevent games and apps from loading.To test locally, use a simple HTTP server such as Python’s built-in one:
python3 -m http.server 8000
Then open http://localhost:8000 in your browser.

Large Game File Sizes

Some games in the /projects/ directory have very large file sizes. These may time out during upload to free-tier static hosts or fail to load on CDNs that enforce per-file size limits. If you encounter this, consider hosting the large game assets on a separate VPS or object storage bucket and pointing the link field in config/games.json to that external URL instead.

Build docs developers (and LLMs) love