diff --git a/README.md b/README.md
index a329cee..71594ff 100644
--- a/README.md
+++ b/README.md
@@ -77,6 +77,7 @@ useInput((input) => {
 - [Composables (Hooks)](#composables-hooks)
 - [Testing](#testing)
 - [Development](#development)
+- [Contributing](#contributing)
 - [Credits](#credits)
 - [License](#license)
 
@@ -172,6 +173,10 @@ vp run -r build       # build all packages
 vue-tui dev           # start an example with HMR
 ```
 
+## Contributing
+
+Contributions welcome! vue-tui is evolving fast — please open an issue before starting large changes. If you use AI tools, disclose it in your PR and make sure you've reviewed and tested everything before submitting.
+
 ## Credits
 
 vue-tui is built on the ideas pioneered by [Ink](https://github.com/vadimdemedes/ink) — component model, yoga-based layout, focus system, and rendering pipeline — adapted to Vue's philosophy. Thanks to [Vadim Demedes](https://github.com/vadimdemedes), [Sindre Sorhus](https://github.com/sindresorhus), and the [Ink contributors](https://github.com/vadimdemedes/ink/graphs/contributors).