BlueGit

timfa posprint

Files

posprint / README.md

README.md

README.md 2.1 KiB Download Raw

posprint

Cross-platform designer for POS (point-of-sale) receipt documents. Edit templates in a markdown-like syntax, preview output live, substitute runtime parameters, and print directly to USB or Bluetooth thermal printers via raw ESC/POS bytes.

Target platforms: Windows and Linux (x64).

Status

Pre-implementation — design phase. See docs/ for specifications.

Design documents

DocumentDescription
FEASIBILITY.mdFeasibility assessment, complexity estimate, risks
LANGUAGE-CHOICE.mdLanguage and framework recommendation
ARCHITECTURE.mdSystem architecture and module breakdown
DSL-SPEC.mdDocument markup language (.pos body syntax)
FILE-FORMAT.md.pos file envelope (metadata + body)
PRINTING.mdPrinter discovery, transport, ESC/POS pipeline

Planned features

  • Markdown-like template editor with live preview
  • Page width: auto-scale to window or fixed width (mm)
  • Save and load .pos files
  • Parameter tokens (${DocumentNumber}) with print-time popup and value reuse
  • Barcodes, QR codes, and images (including parameterized content)
  • Print to USB / Bluetooth POS printers via raw byte streams

Quick feasibility summary

Verdict: feasible for a small team or solo developer, with the printing layer as the main engineering risk.

AreaComplexityNotes
Editor + preview UIMediumWell-trodden path
DSL parser + rendererMediumCustom grammar, bounded scope
ParametersLowStraightforward substitution
Barcodes / QR / imagesLow–MediumMature libraries exist
USB / BT printer I/OHighOS differences, device quirks
Overall (MVP)Medium–High~6–10 weeks for one experienced dev

Stack: Rust + egui (single language, minimal dependencies). USB-serial printing only in v1. See LANGUAGE-CHOICE.md and docs/HELP.md.

Source
1# posprint
2
3Cross-platform designer for POS (point-of-sale) receipt documents. Edit templates in a markdown-like syntax, preview output live, substitute runtime parameters, and print directly to USB or Bluetooth thermal printers via raw ESC/POS bytes.
4
5**Target platforms:** Windows and Linux (x64).
6
7## Status
8
9Pre-implementation — design phase. See [docs/](docs/) for specifications.
10
11## Design documents
12
13| Document | Description |
14|----------|-------------|
15| [FEASIBILITY.md](docs/FEASIBILITY.md) | Feasibility assessment, complexity estimate, risks |
16| [LANGUAGE-CHOICE.md](docs/LANGUAGE-CHOICE.md) | Language and framework recommendation |
17| [ARCHITECTURE.md](docs/ARCHITECTURE.md) | System architecture and module breakdown |
18| [DSL-SPEC.md](docs/DSL-SPEC.md) | Document markup language (`.pos` body syntax) |
19| [FILE-FORMAT.md](docs/FILE-FORMAT.md) | `.pos` file envelope (metadata + body) |
20| [PRINTING.md](docs/PRINTING.md) | Printer discovery, transport, ESC/POS pipeline |
21
22## Planned features
23
24- Markdown-like template editor with live preview
25- Page width: auto-scale to window or fixed width (mm)
26- Save and load `.pos` files
27- Parameter tokens (`${DocumentNumber}`) with print-time popup and value reuse
28- Barcodes, QR codes, and images (including parameterized content)
29- Print to USB / Bluetooth POS printers via raw byte streams
30
31## Quick feasibility summary
32
33**Verdict: feasible** for a small team or solo developer, with the printing layer as the main engineering risk.
34
35| Area | Complexity | Notes |
36|------|------------|-------|
37| Editor + preview UI | Medium | Well-trodden path |
38| DSL parser + renderer | Medium | Custom grammar, bounded scope |
39| Parameters | Low | Straightforward substitution |
40| Barcodes / QR / images | Low–Medium | Mature libraries exist |
41| USB / BT printer I/O | **High** | OS differences, device quirks |
42| **Overall (MVP)** | **Medium–High** | ~6–10 weeks for one experienced dev |
43
44Stack: **Rust + egui** (single language, minimal dependencies). USB-serial printing only in v1. See [LANGUAGE-CHOICE.md](docs/LANGUAGE-CHOICE.md) and [docs/HELP.md](docs/HELP.md).