git clone https://github.com/chaqchase/lla.git
cd lla

cargo build

cargo test

cargo run -- -l

lla/
├── lla/                          # Main application
│   ├── src/
│   │   ├── commands/             # Command implementations
│   │   ├── formatter/            # Output formatters
│   │   ├── lister/               # Directory listers
│   │   ├── plugin/               # Plugin system
│   │   ├── sorter/               # Sorting algorithms
│   │   ├── filter/               # File filtering
│   │   └── theme/                # Theme engine
│   └── Cargo.toml
├── lla_plugin_interface/         # Plugin FFI interface
├── lla_plugin_utils/             # Plugin helper utilities
├── plugins/                      # First-party plugins
│   ├── file_meta/
│   ├── git_status/
│   └── ...
└── themes/                       # Built-in themes

// ✅ Good: Clear, idiomatic Rust
pub fn format_file_size(bytes: u64) -> String {
    const UNITS: &[&str] = &["B", "KB", "MB", "GB", "TB"];
    
    if bytes == 0 {
        return "0 B".to_string();
    }
    
    let unit_index = (bytes as f64).log(1024.0).floor() as usize;
    let size = bytes as f64 / 1024_f64.powi(unit_index as i32);
    
    format!("{:.1} {}", size, UNITS[unit_index])
}
 
// ❌ Bad: Unclear, not idiomatic
pub fn fmt_sz(b: u64) -> String {
    let mut x = b as f64;
    let mut i = 0;
    while x >= 1024.0 {
        x /= 1024.0;
        i += 1;
    }
    format!("{:.1} {}", x, ["B", "KB", "MB"][i])
}

/// Formats a file size in bytes to human-readable format.
/// 
/// # Examples
/// ```
/// assert_eq!(format_file_size(1024), "1.0 KB");
/// assert_eq!(format_file_size(1536), "1.5 KB");
/// ```
pub fn format_file_size(bytes: u64) -> String {
    // Implementation
}

// ✅ Good: Returns Result with context
pub fn read_config(path: &Path) -> Result<Config, ConfigError> {
    let contents = fs::read_to_string(path)
        .map_err(|e| ConfigError::ReadFailed {
            path: path.to_path_buf(),
            source: e,
        })?;
    
    toml::from_str(&contents)
        .map_err(|e| ConfigError::ParseFailed {
            path: path.to_path_buf(),
            source: e,
        })
}
 
// ❌ Bad: Panics on error
pub fn read_config(path: &Path) -> Config {
    let contents = fs::read_to_string(path).unwrap();
    toml::from_str(&contents).unwrap()
}

#[cfg(test)]
mod tests {
    use super::*;
    
    #[test]
    fn test_basic_functionality() {
        let result = some_function("input");
        assert_eq!(result, expected);
    }
    
    #[test]
    fn test_error_handling() {
        let result = some_function_that_can_fail("invalid");
        assert!(result.is_err());
    }
    
    #[test]
    fn test_edge_case() {
        let result = some_function("");
        assert_eq!(result, expected_for_empty);
    }
}

type(scope): brief description
 
Longer explanation if needed. Wrap at 72 characters.
 
Fixes #123

feat(formatter): add JSON output format
 
Implements JSON serialization for all formatters with proper
schema versioning. Includes --pretty flag for formatted output.
 
Closes #45
 
---
 
fix(plugin): prevent crash on missing metadata
 
Add null checks before accessing entry metadata in the plugin
decorator. This prevents panics when processing special files.
 
Fixes #78
 
---
 
docs(readme): update installation instructions
 
Add instructions for new package managers and clarify
manual installation steps for ARM systems.

lla-website/content/docs/
├── about/           # Introduction, installation, architecture
├── usage/           # User guides
├── plugins/         # Plugin system docs
├── guides/          # Tutorials and walkthroughs
├── reference/       # API and configuration reference
└── support/         # FAQ, troubleshooting, contributing

## Description
Clear description of the bug
 
## To Reproduce
Steps to reproduce:
1. Run command: `lla -l ...`
2. Expected: X
3. Actual: Y
 
## Environment
- lla version: `lla --version`
- OS: macOS 13.0 / Ubuntu 22.04 / etc.
- Terminal: iTerm2 / Alacritty / etc.
- Rust version: `rustc --version` (if building from source)
 
## Logs

 
## Screenshots
If applicable, add screenshots
 
## Additional Context
Any other relevant information

## Feature Description
What feature would you like?
 
## Motivation
Why is this feature needed?
What problem does it solve?
 
## Proposed Solution
How could this work?
 
## Alternatives Considered
What alternatives have you thought about?
 
## Examples
Show what usage would look like:
```bash
lla --new-feature

 
## Community Support
 
Help other users:
- Answer questions in discussions
- Share solutions to common problems
- Write blog posts and tutorials
- Create video tutorials
- Share on social media
 
## Code of Conduct
 
We are committed to providing a welcoming and inclusive community. All contributors must adhere to our Code of Conduct:
 
**Our Pledge:**
- Be respectful and considerate
- Welcome newcomers
- Accept constructive criticism
- Focus on what's best for the community
- Show empathy towards others
 
**Unacceptable Behavior:**
- Harassment or discrimination
- Trolling or insulting comments
- Personal or political attacks
- Publishing others' private information
- Other conduct inappropriate in a professional setting
 
**Enforcement:**
Violations may result in temporary or permanent ban from the project.
 
**Reporting:**
Report violations to the maintainers via GitHub or email.
 
## Recognition
 
We value all contributions:
 
**Contributors are recognized:**
- In the changelog for releases
- In the repository's contributor list
- In release notes for significant contributions
 
**Hall of Fame:**
Outstanding contributors may be invited to become maintainers.
 
## Getting Help
 
Need help contributing?
 
- **Documentation**: Read this guide and other docs
- **Discussions**: Ask questions on GitHub Discussions
- **Issues**: Comment on issues you want to work on
- **Discord**: Join our community chat (link in README)
 
## Legal
 
By contributing, you agree that:
- Your contributions will be licensed under the MIT License
- You have the right to submit the contribution
- You understand the project's license
 
## Thank You!
 
Thank you for contributing to lla! Your efforts make the project better for everyone.
 
**Quick Links:**
- [GitHub Repository](https://github.com/chaqchase/lla)
- [Issue Tracker](https://github.com/chaqchase/lla/issues)
- [Discussions](https://github.com/chaqchase/lla/discussions)
- [Changelog](https://github.com/chaqchase/lla/blob/main/CHANGELOG.md)
 
Happy contributing! 🚀