diff --git a/phpstan.neon b/phpstan.neon
new file mode 100644
index 0000000..d6e669c
--- /dev/null
+++ b/phpstan.neon
@@ -0,0 +1,20 @@
+# Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
+# SPDX-License-Identifier: GPL-3.0-or-later
+# FILE INFORMATION
+# DEFGROUP: Config.StaticAnalysis
+# INGROUP: Development
+# BRIEF: PHPStan configuration for Joomla extension static analysis
+
+parameters:
+  level: 5
+  paths:
+    - src
+  scanDirectories:
+    # Joomla framework stubs (if available)
+    - vendor/joomla
+  ignoreErrors:
+    # Joomla service-container architecture: Factory/Container returns mixed
+    - '#Call to an undefined method Joomla\\CMS\\Application\\.*::get#i'
+    - '#Call to method .* on an unknown class Joomla\\Cms\\Extension\\.*#'
+    # Joomla MVC pattern: Table::getInstance returns Table|bool
+    - '#Method Joomla\\CMS\\Table\\Table::getInstance#'