# XLFill Documentation

> A Go library for template-first Excel report generation. Design in Excel, fill with Go.

## Key Features
- Template-first approach: Design in Excel, fill with Go
- Preserves all Excel formatting (fonts, colors, borders, merged cells)
- Support for loops (jx:each), conditionals (jx:if), and grids (jx:grid)
- Formula support with automatic expansion
- Image insertion with automatic sizing
- Custom command extensibility
- Zero styling code required

## Installation
```bash
go get github.com/javajack/xlfill
```

## Quick Start
1. Design your Excel template with expressions like ${data.Field}
2. Add commands in cell comments (e.g., jx:each for loops)
3. Call xlfill.Fill(templatePath, outputPath, data) from Go
4. Get a fully formatted Excel file with your data

## Project Links
- GitHub: https://github.com/javajack/xlfill
- Documentation: https://javajack.github.io/xlfill/
- Author: Rakesh Waghela (https://x.com/webiyo)