diff --git a/pyproject.toml b/pyproject.toml
new file mode 100644
index 0000000..00834f3
--- /dev/null
+++ b/pyproject.toml
@@ -0,0 +1,26 @@
+[project]
+name = "pico-time"
+version = "0.0.1"
+description = "MicroPython show local time on an SSD1306 display."
+readme = "README.md"
+requires-python = ">=3.9"
+authors = [
+  { name = "Gregory Ballantine" }
+]
+
+[tool.ruff]
+target-version = "py312"
+line-length = 100
+
+[tool.ruff.lint]
+# Select Pyflakes (F) and pycodestyle errors (E)
+select = ["E", "F", "W"]
+
+# Ignore warnings that clash with typical embedded / MicroPython conventions
+ignore = [
+    "E501", # Line too long (useful for binary tables / long MQTT payloads)
+]
+
+# Tell the linter that these are built-in globals on the Pico
+[tool.ruff.lint.flake8-builtins]
+builtins-ignorelist = ["machine", "network"]