Bogg

One-time Firebase setup

Multiplayer needs a free Firebase Realtime Database. Once set up, this stays a single static HTML file on GitHub Pages.

1. Go to console.firebase.google.com and click Add project.
2. Build → Authentication → Get started → Sign-in method, enable Anonymous. (No login UI; just gives each device a uid the rules can pin to.)
3. Build → Realtime Database → Create Database. Pick a region. Start in locked mode.
4. Open the Rules tab and paste the JSON below, then Publish.
5. Project Overview → Add app → Web (the </> icon). Skip hosting.
6. Copy the firebaseConfig = {…} snippet.
7. In index.html, find the FIREBASE CONFIG block (near the top of the <script> section) and paste your config replacing the empty object. Commit, push.

{
  "rules": {
    "rooms": {
      "$code": {
        ".read": "auth != null",
        ".write": "auth != null && !data.exists() && newData.child('hostId').val() === auth.uid",
        ".validate": "$code.matches(/^[A-Z0-9]{4,5}$/)",
        "hostId":    { ".write": "auth != null && (data.val() === auth.uid || root.child('rooms/'+$code+'/players/'+data.val()+'/status').val() === 'gone' || !root.child('rooms/'+$code+'/players/'+data.val()).exists())" },
        "status":    { ".write": "auth != null && auth.uid === root.child('rooms/'+$code+'/hostId').val()", ".validate": "newData.isString() && newData.val().length < 16" },
        "board":     { ".write": "auth != null && auth.uid === root.child('rooms/'+$code+'/hostId').val()" },
        "round":     { ".write": "auth != null && auth.uid === root.child('rooms/'+$code+'/hostId').val()" },
        "startTime": { ".write": "auth != null && auth.uid === root.child('rooms/'+$code+'/hostId').val()" },
        "endTime":   { ".write": "auth != null && auth.uid === root.child('rooms/'+$code+'/hostId').val()" },
        "createdAt": { ".write": "auth != null && !data.exists()" },
        "settings": {
          ".write": "auth != null && auth.uid === root.child('rooms/'+$code+'/hostId').val()",
          "size":   { ".validate": "newData.isNumber() && newData.val() >= 3 && newData.val() <= 8" },
          "timer":  { ".validate": "newData.isNumber() && newData.val() >= 0 && newData.val() <= 1800" },
          "minLen": { ".validate": "newData.isNumber() && newData.val() >= 3 && newData.val() <= 8" }
        },
        "players": {
          "$pid": {
            ".write": "auth != null && auth.uid === $pid",
            "name": { ".validate": "newData.isString() && newData.val().length <= 24" }
          }
        },
        "rounds": {
          "$r": {
            "foundBy": {
              "$pid": {
                ".write": "auth != null && auth.uid === $pid",
                "$word": { ".validate": "$word.length <= 16 && newData.child('len').isNumber()" }
              }
            }
          }
        }
      }
    }
  }
}