From f75a7992f8ad704026e9f7b2dc42d5b0049a83f2 Mon Sep 17 00:00:00 2001
From: Esther Lornah <estherlornah2020@gmail.com>
Date: Sat, 28 Feb 2026 13:16:28 +0300
Subject: [PATCH] docs: add Blueprint codegen guide page

---
 .../content/docs/guides/blueprint-codegen.mdx | 39 +++++++++++++++++++
 1 file changed, 39 insertions(+)
 create mode 100644 docs/content/docs/guides/blueprint-codegen.mdx

diff --git a/docs/content/docs/guides/blueprint-codegen.mdx b/docs/content/docs/guides/blueprint-codegen.mdx
new file mode 100644
index 00000000..c2d70a8b
--- /dev/null
+++ b/docs/content/docs/guides/blueprint-codegen.mdx
@@ -0,0 +1,39 @@
+---
+title: Blueprint Codegen Guide
+description: A step-by-step guide to using the Blueprint module in the Evolution SDK
+---
+
+# Blueprint Codegen Guide
+
+The **Blueprint** module of the Evolution SDK provides a code generation pipeline that converts Plutus artifacts (like `plutus.json`) into strongly-typed TypeScript bindings. This allows developers to safely interact with compiled smart contracts in their applications.
+
+---
+
+## When To Use Blueprint
+
+Use Blueprint when:
+
+- You have compiled a smart contract using **Aiken**
+- You have generated a `plutus.json` file
+- You want type-safe contract bindings in TypeScript
+
+---
+
+## Workflow
+
+1. Write and compile your contract using **Aiken**
+2. Obtain the `plutus.json` artifact
+3. Run the **Blueprint codegen**
+4. Import the generated TypeScript files into your project
+
+---
+
+## Example Usage
+
+```ts
+import { generateBlueprint } from "@evolution-sdk/blueprint"
+
+generateBlueprint({
+  input: "./plutus.json",
+  output: "./src/generated"
+})
\ No newline at end of file