poi-tl is a Word template engine that generates new DOCX documents based on Word templates and data, built on Apache POI.
The tool solves the problem of programmatically creating styled Word documents while preserving template formatting. Rather than building documents from scratch through code, poi-tl lets developers design templates in Microsoft Word with rich styling, then populate them with data at runtime. The engine uses a logic-less templating approach with tags that can be replaced with text, images, or tables, and other tags that hide content or loop document sections. Custom functions (plug-ins) can be executed anywhere in the template to handle specialized document generation tasks.
Poi-tl suits projects where styled Word document generation is a core requirement and where designers need to control document appearance through templates rather than code. It works well for report generation, mail merges, and document automation where preserving template styles in the output is important. The logic-less design keeps templates focused on presentation rather than application logic, making them maintainable by non-programmers. Unlike text template engines such as FreeMarker or Velocity that generate HTML or configuration files, poi-tl specifically targets Word document generation and retains the visual formatting of the original template in generated output.
The project shows consistent maintenance with regular updates addressing bug fixes and feature requests. Development activity includes responsive handling of user-reported issues and steady incorporation of community feedback. The maintainers actively document the tool through examples and guides, indicating attention to usability. Updates appear to balance stability with incremental improvements to the template engine's capabilities.
