docs: add editor and frontend screenshots to readmes

Add the two screenshots from the assets/ folder to both README.md (GitHub) and readme.txt (WordPress.org), and commit the assets/ directory so the relative image references resolve.

.gitignore

@@ -7,3 +7,7 @@ build/
 # Playwright test output (created by `npx playwright test`).
 test-results/
 playwright-report/
+
+.superpowers/
+docs/
+.vscode/

README.md

@@ -0,0 +1,86 @@
+# 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
+
+## Screenshots
+
+### Editor
+
+The block's inspector panel in the WordPress block editor. The filter swatch grid sits in the right-hand sidebar alongside the intensity slider.
+
+![Editor view showing the filter swatches and intensity slider in the sidebar](assets/editor-screenshot.png)
+
+### Frontend
+
+All eight filter presets applied to the same image, side by side. From left to right, top to bottom: Normal, Warm, Cool, Vivid, Fade, Mono, Dramatic, Sepia.
+
+![Grid of all eight filter presets applied to a stock image](assets/frontend-screenshot.png)
+
+## 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)

readme.txt

@@ -17,6 +17,20 @@ 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.
 
+== Screenshots ==
+
+1. The block's inspector panel in the WordPress block editor. The filter
+   swatch grid sits in the right-hand sidebar alongside the intensity
+   slider.
+
+   ![Editor view showing the filter swatches and intensity slider in the sidebar](assets/editor-screenshot.png)
+
+2. All eight filter presets applied to the same image, side by side. From
+   left to right, top to bottom: Normal, Warm, Cool, Vivid, Fade, Mono,
+   Dramatic, Sepia.
+
+   ![Grid of all eight filter presets applied to a stock image](assets/frontend-screenshot.png)
+
 == Changelog ==
 
 = 0.1.0 =

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' );