diff --git a/docs/contributing/code-style/enums.md b/docs/contributing/code-style/enums.md
new file mode 100644
index 000000000..5ed0044a5
--- /dev/null
+++ b/docs/contributing/code-style/enums.md
@@ -0,0 +1,25 @@
+# TypeScript Const Enums
+
+We don't use Typescript enums because they are not fully type-safe and can cause surprises. Instead
+of using enums, we use constant objects.
+
+## Our Recommended Approach
+
+```ts
+export const PasskeyActions = {
+  Register: "register",
+  Authenticate: "authenticate",
+} as const;
+
+export type PasskeyActionValue = (typeof PasskeyActions)[keyof typeof PasskeyActions];
+
+declare function usePasskeyAction(action: PasskeyActionValue): void;
+
+usePasskey(PasskeyActions.Register); // ✅ Valid
+usePasskey(0); // ❌ Invalid
+```
+
+## Resources Used
+
+- https://dev.to/ivanzm123/dont-use-enums-in-typescript-they-are-very-dangerous-57bh
+- https://www.typescriptlang.org/docs/handbook/enums.html#objects-vs-enums