maaslalani/sheets

Hi verysleepylemon, unfortunately on my debian13 version 0.2.0 does not have the help command.

Thanks.

> Good news: a help command was added in v0.2.0 (yesterday's release). In the command prompt:
>
> ```
> :help or :?
> ```
>
> Press `:` to open the command bar, type `?` and hit Enter — it prints the full keybinding reference.
>
> **For a popup overlay** (so it's accessible from normal mode without going through the command bar, activated by e.g. `?` in normal mode), here is the BubbleTea pattern:

Hey @maaslalani @verysleepylemon feel free to take a look at my PR https://github.com/maaslalani/sheets/pull/26

Good news: a help command was added in v0.2.0 (yesterday's release). In the command prompt:

```
:help or :?
```

Press `:` to open the command bar, type `?` and hit Enter — it prints the full keybinding reference.

**For a popup overlay** (so it's accessible from normal mode without going through the command bar, activated by e.g. `?` in normal mode), here is the BubbleTea pattern:

```go
// In model.go — add a flag
type model struct {
// ... existing fields ...
showHelp bool
}

// In Update() — normal mode, before other bindings
case "?":
m.showHelp = !m.showHelp
return m, nil

// In View() — overlay on top of the grid
func (m model) View() string {
if m.showHelp {
return m.helpOverlay()
}
return m.gridView()
}

// helpOverlay renders a centered box using lipgloss
func (m model) helpOverlay() string {
style := lipgloss.NewStyle().
Border(lipgloss.RoundedBorder()).
Padding(1, 2).
...

This is a well-scoped proposal. Adding to the Helix-style TOML angle @maaslalani raised:

Helix (`~/.config/helix/config.toml`) uses a `[keys.normal]` / `[keys.insert]` table structure. Here's what that would look like for `sheets`:

```toml
# ~/.config/sheets/config.toml (XDG-friendly path)

[keys.normal]
"C-c" = "quit" # single key: Ctrl-C → quit
"Z" = { "Z" = "write_quit" } # nested: ZZ → :wq

[keys.insert]
"C-c" = "normal_mode"

[keys.normal."g"] # prefix table: all g-prefixed sequences
"g" = "goto_top"
"B9" = "goto_cell"
```

**Advantages over vim-style map syntax:**
- Pure TOML: no custom parser needed — standard `encoding/toml` handles it (`github.com/BurntSushi/toml` or `github.com/pelletier/go-toml/v2` are zero-CGO and small)
- Nested tables naturally express multi-key sequences (`ZZ`, `gB9`, ``)
- `set` options can live in `[options]` alongside bindings later without format changes
- Editor-native: Helix users expect t...

This is a well-scoped proposal. Adding to the Helix-style TOML angle @maaslalani raised:

Helix (`~/.config/helix/config.toml`) uses a `[keys.normal]` / `[keys.insert]` table structure. Here's what that would look like for `sheets`:

```toml
# ~/.config/sheets/config.toml (XDG-friendly path)

[keys.normal]
"C-c" = "quit" # single key: Ctrl-C → quit
"Z" = { "Z" = "write_quit" } # nested: ZZ → :wq

[keys.insert]
"C-c" = "normal_mode"

[keys.normal."g"] # prefix table: all g-prefixed sequences
"g" = "goto_top"
"B9" = "goto_cell"
```

**Advantages over vim-style map syntax:**
- Pure TOML: no custom parser needed — standard `encoding/toml` handles it (`github.com/BurntSushi/toml` or `github.com/pelletier/go-toml/v2` are zero-CGO and small)
- Nested tables naturally express multi-key sequences (`ZZ`, `gB9`, ``)
- `set` options can live in `[options]` alongside bindings later without format changes
- Editor-native: Helix users expect t...

We definitely need to have something like this! Personally, as a Helix user I wonder if we can make the config similar to that? I'm open to opinions.

Thank you, am an emacs user, do not like modal editors 🤮

Hey! I can definitely add this, but please do check out `vimtutor`. It's very much worth the investment to learn!