new: default config setup

Author: Enubia

TODO.md

@@ -4,6 +4,9 @@
 
 Rewrite Ghost Chat from Electron to **Wails v2** with a **Go** backend and **React + TypeScript** frontend.
 
+### Learning approach
+When introducing new Go syntax or concepts, always provide a **Node.js/TypeScript equivalent** for comparison. For example: `goroutine` ≈ `Promise`/`async`, `channel` ≈ `EventEmitter`, `interface` ≈ `interface` (but implicit), `defer` ≈ `finally`, etc.
+
 ### Key changes from the original app
 - **Drop**: Kick support, JChat/KapChat third-party renderers, auto-updater (for now), custom CSS/JS injection
 - **Keep**: Twitch, YouTube, External sources, system tray, i18n, global hotkeys, transparent overlay, dark/light theme
@@ -28,14 +31,14 @@ Rewrite Ghost Chat from Electron to **Wails v2** with a **Go** backend and **Rea
 - [x] Install Go (1.22+) via your package manager or https://go.dev/dl
 - [x] Verify: `go version` → go1.25.7 linux/amd64
 - [x] Set up your editor (VS Code + Go extension, or GoLand)
-- [ ] **Learn**: Read [A Tour of Go](https://go.dev/tour/) — covers variables, types, functions, control flow, structs, interfaces, goroutines, channels
+- [x] **Learn**: Read [A Tour of Go](https://go.dev/tour/) — covers variables, types, functions, control flow, structs, interfaces, goroutines, channels
 
 ### 0.2 Go warm-up exercises
 - [x] Write a "hello world" main package
 - [x] Write a program that reads/writes a JSON file (this is the pattern you'll use for the config store)
 - [x] Write a program that connects to a WebSocket and prints incoming messages (this is the pattern for Twitch IRC)
 - [x] Write a program that makes HTTP requests and parses JSON responses (this is the pattern for YouTube API)
-- [ ] **Learn**: Understand `struct`, `interface`, `error` handling, `goroutine` + `channel`, `context.Context` for cancellation
+- [x] **Learn**: Understand `struct`, `interface`, `error` handling, `goroutine` + `channel`, `context.Context` for cancellation
 
 ### 0.3 Install Wails and scaffold project
 - [x] Install Wails CLI: `go install github.com/wailsapp/wails/v2/cmd/wails@latest`
@@ -47,7 +50,7 @@ Rewrite Ghost Chat from Electron to **Wails v2** with a **Go** backend and **Rea
   - `frontend/` — React + Vite app
   - `wails.json` — project config
 - [x] Run `wails dev` and confirm the template app launches
-- [ ] **Learn**: Read [Wails v2 docs](https://wails.io/docs/introduction) — understand bindings, events, runtime API, window options
+- [x] **Learn**: Read [Wails v2 docs](https://wails.io/docs/introduction) — understand bindings, events, runtime API, window options
 
 ### 0.4 Understand Wails ↔ Frontend communication
 - [x] Add a Go method to `app.go` that returns a string, call it from frontend
@@ -62,7 +65,7 @@ Rewrite Ghost Chat from Electron to **Wails v2** with a **Go** backend and **Rea
 > **Goal**: Set up the real project structure, config persistence, and window basics.
 
 ### 1.1 Project structure
-- [ ] Reorganize the scaffolded project into this layout:
+- [x] Reorganize the scaffolded project into this layout:
   ```
   ghost-chat/
   ├── main.go                  # Entry point
@@ -101,28 +104,16 @@ Rewrite Ghost Chat from Electron to **Wails v2** with a **Go** backend and **Rea
   │   └── package.json
   └── wails.json
   ```
-- [ ] **Learn**: The `internal/` directory is a Go convention — packages inside cannot be imported by external modules. It signals "private to this project."
+- [x] **Learn**: The `internal/` directory is a Go convention — packages inside cannot be imported by external modules. It signals "private to this project."
 
 ### 1.2 Config store (Go)
-- [ ] Define the `Config` struct in `internal/config/config.go` mirroring your app's settings:
-  ```go
-  type Config struct {
-      Version     string       `json:"version"`
-      Window      WindowState  `json:"window"`
-      Settings    Settings     `json:"settings"`
-      General     General      `json:"general"`
-      Keybinds    Keybinds     `json:"keybinds"`
-      Twitch      TwitchConfig `json:"twitch"`
-      YouTube     YouTubeConfig `json:"youtube"`
-      External    ExternalConfig `json:"external"`
-  }
-  ```
-- [ ] Implement `Load(path string) (*Config, error)` — reads JSON file, returns config with defaults for missing fields
-- [ ] Implement `Save(path string) error` — writes config to JSON file
-- [ ] Implement `GetConfigPath() string` — platform-specific config directory (`os.UserConfigDir()`)
-- [ ] Add default values (equivalent to `StoreDefaults` in the old app)
-- [ ] Write unit tests for Load/Save round-trip
-- [ ] **Learn**: Go error handling (`if err != nil`), `encoding/json` struct tags, `os` package for file I/O
+- [x] Define the `Config` struct in `internal/config/config.go` mirroring your app's settings
+- [x] Implement `Load(path string) (*Config, error)` — reads JSON file, returns config with defaults for missing fields
+- [x] Implement `Save(config *Config, path string) error` — writes config to JSON file
+- [x] Implement `GetConfigPath() (string, error)` — platform-specific config directory (`os.UserConfigDir()`)
+- [x] Add default values (equivalent to `StoreDefaults` in the old app)
+- [x] Write unit tests for Load/Save round-trip
+- [x] **Learn**: Go error handling (`if err != nil`), `encoding/json` struct tags, `os` package for file I/O
 
 ### 1.3 Config migration system (Go)
 - [ ] Implement a migration runner that compares `config.Version` against app version

frontend/package.json.md5

@@ -1 +1 @@
-b9e3d4fa19dd7dd784cd2992a8921790
+cc14ab660329973de150ee1544b37acf

frontend/wailsjs/go/main/App.js

@@ -3,13 +3,13 @@
 // This file is automatically generated. DO NOT EDIT
 
 export function GetAppInfo() {
-    return window['go']['main']['App']['GetAppInfo']();
+  return window['go']['main']['App']['GetAppInfo']();
 }
 
 export function Greet(arg1) {
-    return window['go']['main']['App']['Greet'](arg1);
+  return window['go']['main']['App']['Greet'](arg1);
 }
 
 export function SendTestEvent() {
-    return window['go']['main']['App']['SendTestEvent']();
+  return window['go']['main']['App']['SendTestEvent']();
 }

frontend/wailsjs/runtime/package.json

@@ -1,23 +1,24 @@
 {
-    "name": "@wailsapp/runtime",
-    "version": "2.0.0",
-    "description": "Wails Javascript runtime library",
-    "keywords": [
-        "Go",
-        "Javascript",
-        "Wails"
-    ],
-    "homepage": "https://github.com/wailsapp/wails#readme",
-    "bugs": {
-        "url": "https://github.com/wailsapp/wails/issues"
-    },
-    "license": "MIT",
-    "author": "Lea Anthony <lea.anthony@gmail.com>",
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/wailsapp/wails.git"
-    },
-    "main": "runtime.js",
-    "types": "runtime.d.ts",
-    "scripts": {}
+  "name": "@wailsapp/runtime",
+  "version": "2.0.0",
+  "description": "Wails Javascript runtime library",
+  "main": "runtime.js",
+  "types": "runtime.d.ts",
+  "scripts": {
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wailsapp/wails.git"
+  },
+  "keywords": [
+    "Wails",
+    "Javascript",
+    "Go"
+  ],
+  "author": "Lea Anthony <lea.anthony@gmail.com>",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/wailsapp/wails/issues"
+  },
+  "homepage": "https://github.com/wailsapp/wails#readme"
 }

frontend/wailsjs/runtime/runtime.js

@@ -49,7 +49,7 @@ export function EventsOff(eventName, ...additionalEventNames) {
 }
 
 export function EventsOffAll() {
-    return window.runtime.EventsOffAll();
+  return window.runtime.EventsOffAll();
 }
 
 export function EventsOnce(eventName, callback) {
@@ -239,4 +239,4 @@ export function CanResolveFilePaths() {
 
 export function ResolveFilePaths(files) {
     return window.runtime.ResolveFilePaths(files);
-}
+}

internal/config/config.go

@@ -0,0 +1,93 @@
+package config
+
+type WindowState struct {
+	X              int    `json:"x"`
+	Y              int    `json:"y"`
+	Width          int    `json:"width"`
+	Height         int    `json:"height"`
+	IsClickThrough bool   `json:"is_click_through"`
+	IsTransparent  bool   `json:"is_transparent"`
+	Theme          string `json:"theme"` // "dark" | "light"
+}
+
+type MacOptions struct {
+	QuitOnClose  bool `json:"quit_on_close"`
+	HideDockIcon bool `json:"hide_dock_icon"`
+}
+
+type General struct {
+	Language   string     `json:"language"` // default "en-US"
+	MacOptions MacOptions `json:"mac_options"`
+}
+
+type VanishKeybind struct {
+	Keybind           string `json:"keybind"` // empty by default
+	ActivationMessage string `json:"activation_message"`
+}
+
+type Keybinds struct {
+	Vanish VanishKeybind `json:"vanish"`
+}
+
+type TwitchConfig struct {
+	Channel        string   `json:"channel"`
+	DefaultChannel string   `json:"default_channel"`
+	Fade           bool     `json:"fade"`
+	FadeTimeout    int      `json:"fade_timeout"`
+	Bots           bool     `json:"bots"`
+	HideCommands   bool     `json:"hide_commands"`
+	HideBadges     bool     `json:"hide_badges"`
+	UserBlacklist  []string `json:"user_blacklist"`
+}
+
+type YouTubeConfig struct {
+	ChannelID        string   `json:"channel_id"`
+	DefaultChannelID string   `json:"default_channel_id"`
+	VideoURL         string   `json:"video_url"`
+	Retries          int      `json:"retries"`
+	FetchDelay       int      `json:"fetch_delay"`
+	UserBlacklist    []string `json:"user_blacklist"`
+}
+
+type ExternalConfig struct {
+	DefaultURL string   `json:"default_url"`
+	Sources    []string `json:"sources"`
+}
+
+type Config struct {
+	Version     string         `json:"version"`
+	WindowState WindowState    `json:"window_state"`
+	General     General        `json:"general"`
+	Keybinds    Keybinds       `json:"keybinds"`
+	Twitch      TwitchConfig   `json:"twitch"`
+	YouTube     YouTubeConfig  `json:"youtube"`
+	External    ExternalConfig `json:"external"`
+}
+
+func DefaultConfig() Config {
+	return Config{
+		Version: "1.0.0",
+		WindowState: WindowState{
+			Width:  400,
+			Height: 600,
+			Theme:  "dark",
+		},
+		General: General{
+			Language:   "en-US",
+			MacOptions: MacOptions{},
+		},
+		Keybinds: Keybinds{
+			Vanish: VanishKeybind{
+				ActivationMessage: "VanishKeybind triggered",
+			},
+		},
+		Twitch: TwitchConfig{
+			FadeTimeout: 30,
+		},
+		YouTube: YouTubeConfig{
+			Retries:    50,
+			FetchDelay: 5,
+		},
+		External: ExternalConfig{},
+	}
+}

internal/config/store.go

@@ -0,0 +1,59 @@
+package config
+
+import (
+	"encoding/json"
+	"errors"
+	"os"
+	"path/filepath"
+)
+
+const (
+	AppName        = "ghost-chat"
+	ConfigFileName = "config.json"
+)
+
+func GetConfigPath() (string, error) {
+	userConfigDir, err := os.UserConfigDir()
+
+	if err != nil {
+		return "", err
+	}
+
+	return filepath.Join(userConfigDir, AppName, ConfigFileName), nil
+}
+
+func Load(path string) (*Config, error) {
+	bytes, err := os.ReadFile(path)
+
+	if errors.Is(err, os.ErrNotExist) {
+		defaultConfig := DefaultConfig()
+
+		return &defaultConfig, nil
+	}
+
+	if err != nil {
+		return nil, err
+	}
+
+	var config Config
+
+	if err = json.Unmarshal(bytes, &config); err != nil {
+		return nil, err
+	}
+
+	return &config, nil
+}
+
+func Save(config *Config, path string) error {
+	bytes, err := json.MarshalIndent(config, "", "  ")
+
+	if err != nil {
+		return err
+	}
+
+	if err = os.MkdirAll(filepath.Dir(path), 0755); err != nil {
+		return err
+	}
+
+	return os.WriteFile(path, bytes, 0644)
+}