diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
new file mode 100644
index 0000000..d3e7632
--- /dev/null
+++ b/.github/workflows/ci.yml
@@ -0,0 +1,18 @@
+name: CI
+on:
+  push: { branches: [main] }
+  pull_request:
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      # Vitest 4 (via rolldown) requires Node's util.styleText, added in Node 20.
+      matrix: { node: [20, 22] }
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with: { node-version: '${{ matrix.node }}', cache: npm }
+      - run: npm ci
+      - run: npm run typecheck
+      - run: npm test
+      - run: npm run build
diff --git a/README.md b/README.md
index 74d6c41..00b6ea9 100644
--- a/README.md
+++ b/README.md
@@ -10,6 +10,9 @@
     <a href="https://www.npmjs.com/package/@loopflow/cli">
         <img alt="npm" src="https://img.shields.io/npm/v/@loopflow/cli?color=cb3837">
     </a>
+    <a href="https://github.com/faisalishfaq2005/loopflow/actions/workflows/ci.yml">
+        <img alt="CI" src="https://github.com/faisalishfaq2005/loopflow/actions/workflows/ci.yml/badge.svg">
+    </a>
     <a href="https://github.com/faisalishfaq2005/loopflow/stargazers">
         <img alt="GitHub stars" src="https://img.shields.io/github/stars/faisalishfaq2005/loopflow?style=social">
     </a>