Commodore 64 GitHub Pages Site

Expert assistant for maintaining pawel.codes, a Commodore 64-themed vanity site hosted on GitHub Pages using Jekyll with a BASIC interpreter interface.

Project Structure

The site is organized as:

Core Guidelines

1. Jekyll Configuration

2. JavaScript Architecture

- `c64-terminal.js`: Main terminal interface

- `commands.js`: Built-in commands (HELP, DIR, etc.)

- `programs.js`: BASIC program library

- `wwwbasic.js`: Vendored BASIC interpreter

1. Built-in commands

2. Program library

3. localStorage programs

4. wwwbasic interpreter

5. Error message if no match

3. C64 Authenticity

4. Redirect Management

5. Code Style

6. Security

7. Performance

File Structure Reference

```

pawel.codes/

├── _config.yml # Jekyll configuration

├── CNAME # GitHub Pages domain

├── index.html # Main C64 interface

├── 404.html # C64-styled 404 page

├── _data/

│ └── redirects.yml # Centralized redirect config

├── _includes/

│ └── head.html # Common head elements

├── _layouts/

│ └── default.html # Base layout

│ └── redirect.html # Redirect template

├── _redirects/ # Generated redirect pages

├── assets/

│ ├── css/c64.css # C64 styling

│ ├── js/

│ │ ├── c64-terminal.js

│ │ ├── commands.js

│ │ ├── programs.js

│ │ └── wwwbasic.js

│ └── fonts/

│ ├── C64_Pro_Mono-STYLE.woff2

│ └── C64_Pro-STYLE.woff2

└── docs/ # Reference documentation

```

Testing Checklist

Before deploying changes, verify:

Development Workflow

When modifying the site:

1. **Adding Commands**: Edit `assets/js/commands.js` and register in command routing

2. **Adding Programs**: Edit `assets/js/programs.js` with BASIC code

3. **Adding Redirects**: Update `_data/redirects.yml` and generate redirect pages

4. **Styling Changes**: Edit `assets/css/c64.css` maintaining C64 color scheme

5. **Testing Locally**: Use `jekyll serve` to test before pushing

6. **Font Changes**: Refer to `docs/C64-FONTS-USAGE.md`

7. **BASIC Reference**: Consult `docs/BASIC-REFERENCE.md` for interpreter capabilities

Accessibility

Constraints

Future Features Planned

---

When working on this project, always prioritize C64 authenticity, GitHub Pages compatibility, and vanilla JavaScript simplicity. Respect the retro computing aesthetic while maintaining modern web standards.