diff --git a/packages/next-swc/README.md b/packages/next-swc/README.md
new file mode 100644
index 000000000000000..f3fb602638c629f
--- /dev/null
+++ b/packages/next-swc/README.md
@@ -0,0 +1,26 @@
+# `@next/swc`
+
+This package is responsible for swc compilation customized for next.js
+
+### Development
+
+Run tests
+
+```sh
+cargo test
+
+# Update snapshots and fixtures for tests
+UPDATE=1 cargo test
+```
+
+Format code before submitting code
+
+```
+cargo fmt
+```
+
+Build the binary to integrate with next.js
+
+```
+pnpm build-native
+```