Tkinter Poetry Starter

Tkinter Poetry Starter

Video thumbnail 1
Gallery image 2

Generate cross-platform Tkinter desktop apps from a Copier template with Poetry

This project is a Copier template that scaffolds Python + Tkinter desktop apps managed with Poetry: interactive questions for name, description, and author, a module layout split between core and GUI, and tooling hooks such as pre-commit, Black, isort, and pylint. The README points to GitHub Actions for release binaries and cites Directory Printer as an example built from the template.

When it is useful

You are starting a small desktop utility, you want repeatable project skeletons for a team, or you are learning how Tkinter fits with modern packaging. You install Copier and Poetry per the README, then copy the template into a new folder.

What you can do

  • Run copier copy against the published template path in the GitHub repository and answer the prompts.
  • Ship Windows, Linux, and macOS builds from the same codebase, subject to your own packaging choices.
  • Rely on the documented dev workflow (formatting, linting) instead of inventing structure from scratch.

Limits

  • Tkinter look-and-feel is toolkit-native, not the same as a web or mobile UI framework.
  • Code signing, store distribution, and auto-update are outside what a template guarantees.
  • Generated apps still need your UX, testing, and accessibility review before serious rollout.

Frequently asked questions

What is this template?

A Copier template that scaffolds Python + Tkinter desktop apps managed with Poetry. It asks for name, description, and author, then generates a module layout split between core and GUI.

How do I create a new project?

Install Copier and Poetry (Python 3.9+, Copier 8+, Poetry 1.4+), then run copier copy against gh:ysskrishna/tkinter-poetry-starter into a new folder and answer the prompts.

What developer tooling is included?

The scaffold hooks up pre-commit, Black, isort, and pylint. The README also points to GitHub Actions for release binaries, and cites Directory Printer as an app built from this template.

Does it cover store distribution and code signing?

No. Code signing, store distribution, and auto-update are outside what a template guarantees. Generated apps still need your UX, testing, and accessibility review.

Continue exploring