update readme
This commit is contained in:
82
README.md
82
README.md
@@ -14,7 +14,7 @@ LazyPM is a lightweight project management system that provides three interfaces
|
|||||||
## Features
|
## Features
|
||||||
|
|
||||||
- Issue tracking (bugs, features, tasks, epics, chores)
|
- Issue tracking (bugs, features, tasks, epics, chores)
|
||||||
- Status management (open, in-progress, blocked, deferred, closed)
|
- Status management (open, in-progress, closed)
|
||||||
- Dependency tracking between issues
|
- Dependency tracking between issues
|
||||||
- Labels and comments
|
- Labels and comments
|
||||||
- Statistics and reporting
|
- Statistics and reporting
|
||||||
@@ -22,12 +22,19 @@ LazyPM is a lightweight project management system that provides three interfaces
|
|||||||
|
|
||||||
## Quick Start
|
## Quick Start
|
||||||
|
|
||||||
|
### Prerequisites
|
||||||
|
|
||||||
|
- Go 1.25.6+
|
||||||
|
- Make
|
||||||
|
|
||||||
|
### Installation
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Install dependencies
|
# Install dependencies
|
||||||
go mod tidy
|
go mod tidy
|
||||||
```
|
```
|
||||||
|
|
||||||
### Install make
|
### Make Installation
|
||||||
|
|
||||||
Linux:
|
Linux:
|
||||||
```bash
|
```bash
|
||||||
@@ -43,41 +50,64 @@ winget install --id chocolatey.chocolatey --source winget
|
|||||||
choco install make
|
choco install make
|
||||||
```
|
```
|
||||||
|
|
||||||
### Available make commands
|
## Build Commands
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Build all interfaces
|
# Build all binaries
|
||||||
make build
|
make build # Creates bin/pm, bin/tui, bin/web
|
||||||
|
|
||||||
# Run CLI
|
# Run specific interfaces
|
||||||
make cli
|
make cli # Run CLI interface
|
||||||
|
make tui # Run TUI interface (interactive)
|
||||||
# Run TUI
|
make web # Run Web server (localhost:8080)
|
||||||
make tui
|
|
||||||
|
|
||||||
# Run Web interface
|
|
||||||
make web
|
|
||||||
|
|
||||||
# Development with hot reload
|
# Development with hot reload
|
||||||
make dev
|
make dev # Watch templ files and auto-reload web
|
||||||
|
make tw # Watch Tailwind CSS changes
|
||||||
|
make watch # Run both dev and tw in parallel
|
||||||
|
|
||||||
|
# Maintenance
|
||||||
|
make tidy # Run go mod tidy
|
||||||
|
make clean # Clean build artifacts
|
||||||
|
|
||||||
|
# Install
|
||||||
|
make install-cli # Install CLI with shell completions
|
||||||
|
make completions # Generate shell completion scripts
|
||||||
```
|
```
|
||||||
|
|
||||||
## Project Structure
|
## Project Structure
|
||||||
|
|
||||||
```
|
```
|
||||||
├── cmd/ # Entry points (cli, tui, web)
|
├── bin/ # Compiled binaries
|
||||||
├── internal/ # Core services and models
|
├── cmd/ # Entry points
|
||||||
├── pkg/ # Public packages (CLI, TUI, Web)
|
│ ├── pm/ # CLI main.go
|
||||||
└── .pm/ # Local data storage
|
│ ├── tui/ # TUI main.go
|
||||||
|
│ └── web/ # Web server main.go
|
||||||
|
├── internal/ # Core implementation
|
||||||
|
│ ├── models/ # Data models (beads types)
|
||||||
|
│ ├── service/ # Business logic (beads, statistics)
|
||||||
|
│ └── storage/ # Data persistence
|
||||||
|
├── pkg/ # Public packages
|
||||||
|
│ ├── cli/ # CLI commands and REPL
|
||||||
|
│ ├── tui/ # TUI views and components
|
||||||
|
│ └── web/ # Web handlers, templates, assets
|
||||||
|
└── .pm/ # Local data storage (gitignored)
|
||||||
```
|
```
|
||||||
|
|
||||||
## Requirements
|
## Technology Stack
|
||||||
|
|
||||||
- Go 1.25.6+
|
|
||||||
- SQLite
|
|
||||||
|
|
||||||
## Dependencies
|
|
||||||
|
|
||||||
|
- [Go](https://golang.org/) 1.25.6 - Backend language
|
||||||
- [Cobra](https://github.com/spf13/cobra) - CLI framework
|
- [Cobra](https://github.com/spf13/cobra) - CLI framework
|
||||||
- [templ](https://github.com/a-h/templ) - HTML templating
|
- [Bubbletea](https://github.com/charmbracelet/bubbletea) - TUI framework
|
||||||
- [beads](https://github.com/steveyegge/beads) - Issue tracking engine
|
- [Lipgloss](https://github.com/charmbracelet/lipgloss) - Terminal styling
|
||||||
|
- [Templ](https://github.com/a-h/templ) - HTML templating
|
||||||
|
- [Tailwind CSS v4](https://tailwindcss.com/) + DaisyUI - Web styling
|
||||||
|
- [Beads](https://github.com/steveyegge/beads) - Issue tracking engine
|
||||||
|
|
||||||
|
## Configuration
|
||||||
|
|
||||||
|
LazyPM stores data in a local `.pm` directory:
|
||||||
|
- `.pm/db.db` - SQLite database for issues
|
||||||
|
- `.pm/stats.json` - Statistics storage
|
||||||
|
|
||||||
|
The directory is automatically created on first run.
|
||||||
Reference in New Issue
Block a user