dailychamp.nvim

A Neovim plugin for managing daily task markdown files with the DailyChamp App (Flutter).

Provides powerful shortcuts, templates, and keybindings for efficient daily planning and task management in markdown format. Works seamlessly with semantic markdown parsing - tasks can appear anywhere in your document!

Edit in Neovim, sync with your phone! This plugin uses the same markdown format as the DailyChamp mobile/desktop app.

Features

• Smart day creation - Auto-copies sections from previous day
• Template system - Create days from custom templates (work, personal, etc.)
• Quick task creation with inline editing
• Smart navigation (jump to today, jump to date)
• Intelligent task copying - Copy tasks to same section in next day
• Task management (toggle completion, smart copy)
• Statistics (count completed/total tasks)
• Fully customizable keybindings and templates
• Syntax highlighting for completed/incomplete tasks
• No folding - All days visible by default

Installation

LazyVim / lazy.nvim

Add to your ~/.config/nvim/lua/plugins/dailychamp.lua:

return {
  "gs-deliverists-io/daily-champ.nvim",
  lazy = false,  -- Load at startup for immediate access
  config = function()
    require("dailychamp").setup({
      -- Optional: customize settings
      file_path = vim.fn.expand("~/Nextcloud/dailychamp/daily.md"),
      default_hours = "1.0",
    })
  end,
}

Local Installation (for testing)

# Clone the repository
git clone https://github.com/gs-deliverists-io/dailychamp.nvim.git ~/.config/nvim/pack/plugins/start/dailychamp.nvim

Then restart Neovim.

Default Keybindings

All keybindings use <localleader> prefix (filetype-specific, customizable):

File Operations

Navigation

Day Operations

Task Operations

Section Operations

Info

Configuration

Full Configuration Example

require("dailychamp").setup({
  -- Date formats (using os.date format strings)
  date_format = "%Y-%m-%d",  -- 2026-01-06
  day_format = "%A",         -- Monday
  
  -- Template sections (customize order and names)
  sections = {
    "Goals",
    "Tasks",
    "Notes", 
    "Reflections"
  },
  
  -- Default task time estimate
  default_hours = "1.0",
  
  -- File path (supports ~ expansion)
  file_path = vim.fn.expand("~/Nextcloud/Notes/dailychamp/daily.md"),
})

Note: Keybindings use <localleader> by default, which is filetype-specific and won't conflict with global mappings.

Custom Keybindings

By default, keybindings use <localleader> which only works in dailychamp markdown files. To customize:

-- Change localleader globally (if not already set)
vim.g.maplocalleader = ","

-- Or use a different prefix entirely
require("dailychamp").setup({ leader = "<leader>d" })

-- Or set individual mappings after setup
local dailychamp = require("dailychamp")
vim.keymap.set('n', '<leader>tt', dailychamp.jump_to_today, { desc = 'Jump to today', buffer = true })
vim.keymap.set('n', '<leader>tn', dailychamp.insert_new_day, { desc = 'New day', buffer = true })

Custom Sections

Change the default sections in new day templates:

require("dailychamp").setup({
  sections = {
    "Morning Routine",
    "Deep Work",
    "Tasks",
    "Evening Review"
  }
})

Custom File Path

Point to a different markdown file:

require("dailychamp").setup({
  file_path = vim.fn.expand("~/Documents/daily.md"),
})

Custom Templates

Create reusable day templates in templates/ directory (same location as your daily.md):

# Create templates directory
mkdir -p ~/Nextcloud/dailychamp/templates

# Create a work template
cat > ~/Nextcloud/dailychamp/templates/work.md << 'EOF'
## Morning Standup
## Deep Work
## Meetings
## Tasks
## Notes
EOF

# Create a weekend template
cat > ~/Nextcloud/dailychamp/templates/weekend.md << 'EOF'
## Goals
## Projects
## Learning
## Reflection
EOF

When you use <localleader>N (create day with prompt), you'll be able to select from your templates!

Markdown Format

The plugin works with semantic markdown - tasks (- [ ]) are recognized anywhere in the document!

Example Document

# 2026-01-06 Tuesday

## Goals
- **Primary goal**: Complete the project
- Secondary goal with [link](https://example.com)

## Custom Section
- [ ] Task in custom section | 2.0h
- Regular note here

- [ ] Task without section header | 1.0h

Free paragraph text goes to reflections.

## Tasks
- [x] ~~Completed task~~ | 1.5h
- [ ] Task with **bold** and *italic* | 1.0h

## Reflections
End of day summary.

# 2026-01-05 Monday
...

Task Format

- [ ] Task title | 2.0h          # Incomplete task
- [x] Task title | 1.5h          # Completed task
- [ ] Task with [link](url) | 1h  # Task with markdown

The | X.Xh time estimate is optional. Default is 1.0h.

Commands Reference

All commands available via :DailyChamp<Tab>:

• :DailyChampNewDay - Smart: Jump to today or create (copies from yesterday)
• :DailyChampNewDayPrompt - Create day with date + template picker
• :DailyChampTask - Insert task with prompts
• :DailyChampQuickTask - Insert task inline (fastest)
• :DailyChampToggle - Toggle task completion
• :DailyChampSection - Insert new section
• :DailyChampJumpToday - Jump to today's entry
• :DailyChampJumpDate - Jump to specific date
• :DailyChampCopyTask - Copy task to tomorrow (same section)
• :DailyChampNote - Add note
• :DailyChampStats - Show day statistics
• :DailyChampOpen - Open daily.md file

Workflow Tips

Daily Workflow

1. Start your day: <localleader>o to open daily.md (or use from anywhere!)
2. Create/jump to today: <localleader>n (smart: jumps if exists, creates if not)
3. Add tasks quickly: <localleader>a (opens inline edit)
4. Mark complete: <localleader>x on task line
5. Incomplete task?: <localleader>c to copy to tomorrow
6. Check progress: <localleader>S

Creating New Days

Quick method (<localleader>n):

• Automatically copies sections from yesterday
• If you added custom sections yesterday, they carry forward
• Fastest for daily use

Template method (<localleader>N):

1. Prompts for date
2. Shows template picker:
   • 📅 Copy from previous day
   • 📄 Your custom templates (work, weekend, etc.)
3. Creates day with selected template

Example: Create a work-specific day structure

Copying Tasks Forward

Didn't finish a task today? Copy it to tomorrow:

1. Move cursor to task line
2. Press <localleader>c
3. Task automatically copied to tomorrow's same section
4. If that section doesn't exist in tomorrow, it's created automatically

Smart copying: If your task is in "## Deep Work", it goes to tomorrow's "## Deep Work" section!

Custom Sections

Not limited to default sections! Create any section you need:

<localleader>s  # Prompts for section name

Your custom sections automatically carry forward when you create new days.

Syntax Highlighting

The plugin automatically highlights tasks:

• Incomplete tasks (- [ ]) - Blue color
• Completed tasks (- [x]) - Gray with strikethrough

Viewing

All days are visible by default (no folding). Use standard Vim folding commands if you want to collapse sections manually.

Troubleshooting

Plugin not loading

Check if it's in the right location:

ls -la ~/.local/share/nvim/site/pack/plugins/start/

Keybindings not working

Check your localleader key:

:echo maplocalleader

Set it if undefined (typically in your init.lua):

vim.g.maplocalleader = ","  -- or any other key

Or change the plugin prefix:

require("dailychamp").setup({ leader = "<leader>d" })

Commands not found

Restart Neovim after installation:

:qa
nvim

Customization Examples

Minimal Setup (defaults)

require("dailychamp").setup()

Power User Setup

require("dailychamp").setup({
  file_path = vim.fn.expand("~/sync/daily.md"),
  leader = "<leader>t",  -- Use <leader>t for tasks
  default_hours = "0.5",  -- 30-minute default
  sections = {
    "🎯 Goals",
    "✅ Tasks",
    "📝 Notes",
    "💭 Reflections",
    "🔗 Links"
  },
})

-- Extra custom mappings (buffer-local)
local dailychamp = require("dailychamp")
vim.keymap.set('n', '<leader>tx', function()
  dailychamp.toggle_task()
  dailychamp.copy_task_to_tomorrow()
end, { desc = 'Complete & copy to tomorrow', buffer = true })

Work/Personal Split

-- Two different files with separate configs
vim.keymap.set('n', '<leader>dw', function()
  require("dailychamp").setup({
    file_path = vim.fn.expand("~/work/daily.md"),
  })
  require("dailychamp").open_file()
end, { desc = 'Open work dailychamp' })

vim.keymap.set('n', '<leader>dp', function()
  require("dailychamp").setup({
    file_path = vim.fn.expand("~/personal/daily.md"),
  })
  require("dailychamp").open_file()
end, { desc = 'Open personal dailychamp' })

Integration with DailyChamp App

This plugin is designed to work seamlessly with the DailyChamp App (Flutter):

• Same markdown format - Edit in Neovim, view on your phone/desktop
• Semantic parsing - Tasks work anywhere in the document
• Full markdown support - Bold, links, code blocks, etc.
• Reverse chronological - Newest days at the top
• Sync via cloud - Use Nextcloud, Dropbox, iCloud, or any file sync

Workflow:

1. Edit your daily.md in Neovim (powerful keyboard shortcuts)
2. Sync via your cloud provider
3. View and check off tasks on mobile with the DailyChamp app
4. Changes sync back to Neovim

Get the DailyChamp app: github.com/gs-deliverists-io/daily-champ

License

MIT

Contributing

The plugin is designed to be easily customizable. Feel free to:

1. Fork and modify for your needs
2. Submit PRs for improvements
3. Open issues for bugs/features

Roadmap

Future enhancements being considered:

• Telescope integration for fuzzy date search
• Task templates (recurring tasks)
• Time tracking summaries
• Week view generation
• Export to other formats
• Integration with calendar apps

Contributions and ideas welcome!

Author

Created for the DailyChamp App project.

See Also

• DailyChamp App (Flutter) - Mobile/desktop task management
• LazyVim - Neovim configuration framework