https://github.com/jfaccioli/documint
DocuMint is a lightweight Flask web app that automates the bulk generation of personalised Word documents by merging a .docx template with Excel data. Simply upload a Word file with placeholders and an Excel sheet—DocuMint will create and zip a separate document for each row automatically.
https://github.com/jfaccioli/documint
admin-tools automation-tool bulk-document-generation contract-automation contract-generator document-automation docx-automation excel-to-docx flask mail-merge openpyxl pandas python python-docx small-business-tools template-engine webapp word-documents word-merge
Last synced: 4 months ago
JSON representation
DocuMint is a lightweight Flask web app that automates the bulk generation of personalised Word documents by merging a .docx template with Excel data. Simply upload a Word file with placeholders and an Excel sheet—DocuMint will create and zip a separate document for each row automatically.
- Host: GitHub
- URL: https://github.com/jfaccioli/documint
- Owner: jfaccioli
- Created: 2025-05-05T03:56:40.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-05-12T07:26:45.000Z (9 months ago)
- Last Synced: 2025-10-12T14:37:28.919Z (4 months ago)
- Topics: admin-tools, automation-tool, bulk-document-generation, contract-automation, contract-generator, document-automation, docx-automation, excel-to-docx, flask, mail-merge, openpyxl, pandas, python, python-docx, small-business-tools, template-engine, webapp, word-documents, word-merge
- Language: Python
- Homepage: https://documint.onrender.com/
- Size: 194 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# 📄 DocuMint – Bulk Word Document Generator from Excel Data
**DocuMint** is a web-based document generator that turns Excel spreadsheets into individually customised Word documents using a single template. Perfect for contracts, documents, tenancy forms, and any admin task requiring personalised files — in bulk.
[🟢 Live Demo – Try DocuMint Now](https://documint.onrender.com/)
---
### 🔥 Why DocuMint?
Microsoft Word's Mail Merge is useful — but limited. It only creates one long .docx file with multiple pages for different recipients. You still have to split the document manually.
DocuMint does it better:
Creates separate Word files, one for each row of your Excel spreadsheet
Automatically names each file
Packages them all in a ZIP, ready to download
---
## 🚀 Features
- 📝 Upload a Word `.docx` template with placeholders or merge fields
- 📊 Upload an Excel file with matching column headers
- 🔁 Choose a column to name the generated documents
- 📂 Merge fields into both **paragraphs** and **tables**
- 🗂️ Download a ZIP file with all generated documents
- 🧹 Auto-cleans temporary files after download
---
## ▶️ How to Use
### 1. Prepare Your Excel File
Each row should represent one document. The column headers will become your placeholders.
### 2. Prepare Your Word Template
Use one of the two supported methods:
✅ Option 1: Custom Placeholders
Type placeholders like «First_Name» directly in Word
Replace spaces with underscores to match Excel column names
✅ Option 2: Insert Merge Field (Advanced)
Open Word > Mailings > Select Recipients > Use Existing List…
Load your Excel
Use Insert Merge Field for placeholders (e.g. First_Name)
Save the .docx file
---
## 📁 Project Structure
documint/
├── main.py # Flask app
├── requirements.txt # Python dependencies
├── .gitignore # Git ignored files/folders
├── README.md # Project description
├── templates/ # HTML templates
│ ├── index.html
│ └── choose_column.html
├── static/ # Static assets (e.g. logo)
│ └── generated-icon.png
├── uploads/ # Temporary folder for uploaded files
├── output/ # Temporary folder for processed files
---
## ⚙️ Requirements
- Python 3.8+
- `pip install -r requirements.txt` (includes Flask, pandas, python-docx, openpyxl)
---
## 💼 Example Use Cases
Contracts
Letters of offer or employment
Bulk tenancy agreements
Certificates or registration confirmations
School or healthcare document mail-outs
---
## 🔐 Security Notes
Uploaded and generated files are stored only temporarily.
All files are deleted immediately after ZIP download.