brisbanesocialchess.github.io

Welcome to the source code repository for the Brisbane Social Chess website.

---

About the Site Generator

This website is built using Eleventy (11ty), a modern and flexible static site generator for JavaScript projects. Eleventy takes your content and templates and generates a fast, static website. You do not need to know advanced JavaScript to get started - just follow the steps below!

• Live site: https://www.brisbanesocialchess.org.au/
• Current Development site: https://brisbanesocialchess.github.io/
• Cloudflare Playground: https://cfsite.brisbanesocialchess.workers.dev/
• Read the Docs: https://brisbanesocialchess.readthedocs.io/en/latest/
• CONTRIBUTING Guide
• DEVELOPER_HELP Guide

---

• About Brisbane Social Chess
• Quick Start
• Technology Stack
  • Cloudflare Workers Development
    • Start Development Server
    • Run Tests
  • Getting Started / Building the Site
  • Build the Docker image for running pre-commit easily
  • Build the Documentation
• Contributors

---

About Brisbane Social Chess

Brisbane Social Chess is a not-for-profit organization in Queensland that promotes the game of chess through social gatherings and community engagement. We organize regular meetups where people can play chess in a relaxed and friendly environment. We are registered in Queensland and have a dedicated team of organizers.

---

Quick Start

For detailed development setup instructions, see DEVELOPER_HELP.md.

Experiment with Lerna and bootup a local developer playground from the repository root with: npx lerna run dev.

Technology Stack

• GitHub Pages is a static site hosting service offered by GitHub, enabling users to host websites directly from their GitHub repositories. It is designed for publishing static content, meaning it primarily handles HTML, CSS, and JavaScript files, and does not support server-side languages like PHP or Python for dynamic content generation.
• Read the Docs is a Continuous Documentation Deployment platform designed to simplify the process of building, versioning, and hosting technical documentation, particularly for software projects. It operates on the principle of "docs as code," integrating with version control systems like Git (GitHub, GitLab, Bitbucket) to automatically build and update documentation whenever changes are committed to the repository.
• Cloudflare is a connectivity cloud that provides a range of services to improve the security, performance, and reliability of websites and applications. It acts as a Content Delivery Network (CDN), reverse proxy, and provides cybersecurity solutions. In essence, Cloudflare helps businesses connect, protect, and build their online presence.
• Cloudflare Workers is a serverless platform for building, deploying, and scaling apps across Cloudflare's global network ↗ with a single command - no infrastructure to manage, no complex configuration.
• Cloudflare Wrangler is a command-line tool designed to help developers build and manage applications on the Cloudflare developer platform, particularly for Cloudflare Workers. It streamlines the process of deploying, testing, and configuring Workers, as well as interacting with other Cloudflare developer products.
• Cloudflare D1 is a serverless relational database in seconds with D1. With a familiar SQL query language, point-in-time recovery, and cost-effective pricing, you are empowered to build the next big thing.
• Lerna is a fast, modern build system for managing and publishing multiple JavaScript/TypeScript packages from the same repository.
• Vitest is a blazing-fast, next-generation testing framework designed for modern JavaScript and TypeScript projects, built on top of Vite. It's known for its speed and developer experience, offering instant feedback and seamless integration with Vite's features like hot module replacement (HMR). Vitest is inspired by Jest and aims to provide a familiar yet enhanced testing experience.
• Eleventy (also known as 11ty) is a static site generator. It's a tool that transforms content (like Markdown, HTML, or JavaScript) and templates into static HTML files, making it faster and easier to build websites. Unlike dynamic website builders, 11ty generates all the website's content upfront, which leads to better performance and simpler deployments.
• Tailwind CSS is a utility-first CSS framework designed for rapidly building custom user interfaces directly within HTML. Unlike traditional CSS frameworks that provide pre-built components (like buttons or navigation bars), Tailwind offers a comprehensive set of low-level utility classes.
• Nunjucks is a powerful and flexible templating engine for JavaScript, heavily inspired by Jinja2 (a popular templating engine for Python). It allows developers to create dynamic HTML, XML, or other text-based content by embedding logic, variables, and control structures directly within templates.
• Sphinx is a powerful and widely-used documentation generator written in Python. It is particularly popular within the Python community and is considered the de facto standard for documenting Python projects.
• reStructuredText (RST) is a lightweight markup language designed for creating easy-to-read and easy-to-write plaintext documents that can be automatically converted to various output formats, such as HTML, LaTeX (and thus PDF), and more. It is a key component of the Docutils project and is widely used in the Python community for writing technical documentation, including Python's official documentation and documentation for many Python libraries.
• Docker is an open-source platform designed to simplify the process of building, deploying, and running applications using containerization. It packages an application and all its dependencies (libraries, system tools, code, runtime) into a standardized unit called a "container."

• Makefile is a text file that contains a set of instructions used by the make utility to automate the process of building and managing software projects. It defines dependencies between files and specifies the commands required to update outdated files or generate new ones.

Cloudflare Workers Development

To work with the Cloudflare Workers site in the packages/cfsite directory:

Start Development Server

cd packages/cfsite
npx wrangler dev

Run Tests

cd packages/cfsite
npm run test

Read below for instructions about the current static development site hosted on GitHub Pages.

---

Getting Started / Building the Site

To start a local development server with live reload, run:

npm run tailwindcss:watch & npm run start

---

Build the Docker image for running pre-commit easily

• Standard build:

docker build -t my-go-precommit .

• Build without cache:

docker build --no-cache -t my-go-precommit .

• On a Mac with an M2 chip:

docker build --platform=linux/amd64 -t my-go-precommit .

And then:

• Standard build:

docker run --rm -v "$PWD":/app -w /app my-go-precommit

Or if you want to run and keep the container and go into bash:

docker run -it -v "$PWD":/app -w /app my-go-precommit bash

• On a Mac with an M2 chip:

docker run --platform=linux/amd64 --rm -v "$PWD":/app -w /app my-go-precommit

---

Build the Documentation

Run the following commands from the repo root to create the Sphinx documentation with Make:

cd doc
make html

The generated HTML site will be in the doc/build/html folder. You can open the HTML files with your web browser.

---

Contributors

---

© 2025 Brisbane Social Chess