diff --git a/.gitignore b/.gitignore
index 18a34e8..5e19f35 100644
--- a/.gitignore
+++ b/.gitignore
@@ -7,3 +7,7 @@ build/
 # Playwright test output (created by `npx playwright test`).
 test-results/
 playwright-report/
+
+.superpowers/
+docs/
+.vscode/
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3e89f7a
--- /dev/null
+++ b/README.md
@@ -0,0 +1,72 @@
+# SoloFilters Image Enhancements
+
+Add Instagram-style CSS filters to images in the WordPress block editor.
+
+## About
+
+This WordPress plugin registers a new "Filtered Image" block that lets users pick a named filter preset and adjust its intensity. Filters are applied with CSS only, so they are reversible, lightweight, and the original image keeps its alt text.
+
+## Requirements
+
+- WordPress 6.4+
+- PHP 7.4+
+
+## Installation
+
+1. Clone or download this repository to your WordPress plugins directory:
+
+   ```bash
+   wp-content/plugins/solofilters-image-enhancements/
+   ```
+
+2. Activate the plugin from the WordPress admin panel
+
+## Features
+
+- **Filtered Image Block** – A new block type for applying CSS filters to images
+- **Preset Filters** – Choose from multiple named filter presets
+- **Adjustable Intensity** – Control filter intensity with a slider
+- **Non-destructive** – Filters are applied with CSS only; original images remain unchanged
+- **Accessibility** – Alt text is preserved on filtered images
+
+## Development
+
+### Setup
+
+```bash
+npm install
+```
+
+### Build
+
+```bash
+npm run build
+```
+
+### Testing
+
+Run unit tests:
+
+```bash
+npm run test:jest
+```
+
+Run end-to-end tests:
+
+```bash
+npm run test:e2e
+```
+
+## Changelog
+
+### [0.1.0] - 2026-08-06
+
+- Initial release
+
+## License
+
+GPLv2 or later – [View License](https://www.gnu.org/licenses/gpl-2.0.html)
+
+## Author
+
+[Keith Solomon](https://keithsolomon.net)
diff --git a/solofilters-image-enhancements.php b/solofilters-image-enhancements.php
index 1da4356..64f87ed 100644
--- a/solofilters-image-enhancements.php
+++ b/solofilters-image-enhancements.php
@@ -5,7 +5,8 @@
  * Version:           0.1.0
  * Requires at least: 6.4
  * Requires PHP:      7.4
- * Author:            ksolo
+ * Author:            Keith Solomon
+ * Author URI:        https://keithsolomon.net
  * License:           GPL-2.0-or-later
  * License URI:       https://www.gnu.org/licenses/gpl-2.0.html
  * Text Domain:       solofilters-image-enhancements
@@ -67,4 +68,5 @@ function solofilters_image_enhancements_render_block( array $attributes, string
 function solofilters_image_enhancements_load_textdomain(): void {
     load_plugin_textdomain( 'solofilters-image-enhancements', false, dirname( plugin_basename( __FILE__ ) ) . '/languages' );
 }
+
 add_action( 'init', 'solofilters_image_enhancements_load_textdomain' );