diff --git a/.checkstyle b/.checkstyle
new file mode 100644
index 0000000..b095094
--- /dev/null
+++ b/.checkstyle
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<fileset-config file-format-version="1.2.0" simple-config="true" sync-formatter="false">
+    <local-check-config name="HtmlUnit CSP Checkstyle" location="checkstyle.xml" type="project" description="HtmlUnit CSP Checkstyle Configuration">
+        <property name="checkstyle.suppressions.file" value="${project_loc}/checkstyle_suppressions.xml"/>
+        <additional-data name="protect-config-file" value="false"/>
+    </local-check-config>
+    <fileset name="all" enabled="true" check-config-name="HtmlUnit CSP Checkstyle" local="true">
+        <file-match-pattern match-pattern="^src/.*\.java$" include-pattern="true"/>
+    </fileset>
+    <filter name="NonSrcDirs" enabled="true"/>
+</fileset-config>
diff --git a/.gitignore b/.gitignore
index 76e5279..199fdfa 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,5 +1,4 @@
 /target/
-/.checkstyle
 /.classpath
 /.project
 /.settings/
diff --git a/README.md b/README.md
index 60bfbaa..f85b3a1 100644
--- a/README.md
+++ b/README.md
@@ -181,6 +181,26 @@ Open a command line window from the root folder of the project and call
 mvn compile
 ```
 
+### Eclipse IDE Setup
+
+To work with this project in Eclipse:
+
+1. Install the **Eclipse Checkstyle Plugin** from the Eclipse Marketplace (Help > Eclipse Marketplace)
+   - Search for "Checkstyle Plug-in" and install it
+   
+2. Import the project as a Maven project:
+   - File > Import > Maven > Existing Maven Projects
+   - Select the repository root directory
+   - Click Finish
+
+3. The Checkstyle configuration will be automatically picked up from the `.checkstyle` file in the repository root
+   - The configuration uses `checkstyle.xml` and `checkstyle_suppressions.xml` from the project
+   - All Java files under `src/` will be checked automatically
+
+4. To verify Checkstyle is working:
+   - Right-click the project > Properties > Checkstyle
+   - You should see "HtmlUnit CSP Checkstyle" as the active configuration
+
 ### Running the tests
 
 ```