diff --git a/.gitignore b/.gitignore
index 90a06b4d..ca0cb8ef 100644
--- a/.gitignore
+++ b/.gitignore
@@ -5,6 +5,7 @@ target/
!**/src/test/**/target/
.DS_Store
+Gemfile.lock
### STS ###
.apt_generated
diff --git a/Gemfile b/Gemfile
new file mode 100644
index 00000000..77198cfa
--- /dev/null
+++ b/Gemfile
@@ -0,0 +1,4 @@
+source "https://rubygems.org"
+
+gem "github-pages", "~> 231", group: :jekyll_plugins
+gem "webrick"
diff --git a/README.md b/README.md
index d22a071a..556fa040 100644
--- a/README.md
+++ b/README.md
@@ -4,9 +4,11 @@ Oracle Transaction Manager for Microservices (MicroTx) enables enterprise users
Running sample applications is the fastest way for you to get familiar with MicroTx. Sample applications are microservices that demonstrate how you can integrate your applications with MicroTx while using different transaction protocols. The code of the sample applications includes the MicroTx libraries. You can use the sample applications as a reference while using the MicroTx libraries with your custom applications.
-## Documentation
-
-See [Documentation set for Oracle Transaction Manager for Microservices](https://docs.oracle.com/en/database/oracle/transaction-manager-for-microservices/index.html).
+## Documentation
+
+See [Documentation set for Oracle Transaction Manager for Microservices](https://docs.oracle.com/en/database/oracle/transaction-manager-for-microservices/index.html).
+
+Read the [Oracle MicroTx Blog](https://oracle-samples.github.io/microtx-samples/) for tutorials, deployment guides, workflow resources, and distributed transaction patterns.
## Repository Structure for Sample Applications
@@ -54,4 +56,4 @@ Please consult the [security guide](./SECURITY.md) for our responsible security
Copyright (c) 2023 Oracle and/or its affiliates.
Released under the Universal Permissive License v1.0 as shown at
-.
\ No newline at end of file
+.
diff --git a/docs/_config.yml b/docs/_config.yml
new file mode 100644
index 00000000..77b0df09
--- /dev/null
+++ b/docs/_config.yml
@@ -0,0 +1,67 @@
+title: Oracle MicroTx
+description: Practical articles about Oracle Transaction Manager for Microservices.
+seo_keywords:
+ - Agentic AI
+ - AI Agents
+ - Agentic Workflows
+ - AI-Assisted Workflows
+ - AI-Native Workflows
+ - Compensation Patterns
+ - Conductor OSS
+ - Distributed Transactions
+ - Durable Execution
+ - Durable Workflows
+ - Enterprise AI
+ - Enterprise Workflows
+ - Human Approval
+ - Idempotency
+ - Kubernetes
+ - Long-Running Workflows
+ - MCP
+ - Microservices
+ - MicroTx blogs
+ - Oracle Database
+ - Oracle Database 23ai
+ - Oracle Database 26ai
+ - Oracle Transaction Manager for Microservices
+ - Oracle MicroTx
+ - Oracle MicroTx Free
+ - Oracle MicroTx Workflows
+ - Oracle Cloud Marketplace
+ - Oracle Kubernetes Engine
+ - OCI Resource Manager
+ - Production AI
+ - RAG
+ - Runtime Controls
+ - Saga
+ - Systems of Record
+ - TCC
+ - Temporal
+ - Transaction Coordination
+ - Distributed Transaction Coordinator
+ - Workflow Orchestration
+ - XA
+ - LRA
+url: "https://oracle-samples.github.io"
+baseurl: "/microtx-samples"
+lang: en
+timezone: UTC
+permalink: /:title/
+markdown: kramdown
+highlighter: rouge
+
+plugins:
+ - jekyll-feed
+ - jekyll-seo-tag
+ - jekyll-sitemap
+
+defaults:
+ - scope:
+ path: ""
+ type: posts
+ values:
+ layout: post
+
+exclude:
+ - Gemfile
+ - Gemfile.lock
diff --git a/docs/_data/authors.yml b/docs/_data/authors.yml
new file mode 100644
index 00000000..d7b82821
--- /dev/null
+++ b/docs/_data/authors.yml
@@ -0,0 +1,35 @@
+oracle-microtx-team:
+ name: Oracle MicroTx team
+ role: Oracle MicroTx engineering
+ github: https://github.com/oracle-samples
+ linkedin:
+
+bharath-mc:
+ name: BHARATH MC
+ role: Principal Platform Software Engineer – Oracle MicroTx
+ github:
+ linkedin: https://www.linkedin.com/in/bharath-mc-95578061/
+
+pruthvithej-ramesh-kumar:
+ name: Pruthvithej Ramesh Kumar
+ role: Lead Principal Platform Software Engineer – Oracle MicroTx
+ github:
+ linkedin:
+
+brijesh-deo:
+ name: Brijesh Deo
+ role:
+ github:
+ linkedin:
+
+deepak-goel:
+ name: Deepak Goel
+ role: Vice President, Platform Software Engineering
+ github:
+ linkedin:
+
+shivanshu-singh:
+ name: Shivanshu Singh
+ role:
+ github:
+ linkedin:
diff --git a/docs/_data/external_articles.yml b/docs/_data/external_articles.yml
new file mode 100644
index 00000000..f3d2ab88
--- /dev/null
+++ b/docs/_data/external_articles.yml
@@ -0,0 +1,108 @@
+- title: How Oracle MicroTx Workflows Makes Enterprise Workflow Execution Durable
+ description: Learn how Oracle MicroTx Workflows combines durable orchestration, Oracle Database persistence, and distributed transactions for resilient enterprise workflows and AI agents.
+ date: 2026-07-06 00:00:00 +0000
+ author_id: pruthvithej-ramesh-kumar
+ external: true
+ url: https://blogs.oracle.com/database/durable-workflow-execution-oracle-microtx-workflows
+ tags:
+ - Oracle MicroTx Workflows
+ - Durable Execution
+ - Durable Workflows
+ - Conductor OSS
+ - Oracle Database
+ - Distributed Transactions
+ - Idempotency
+ - Kubernetes
+ - Saga
+ - TCC
+ - XA
+
+- title: "When AI Agents Meet Enterprise Reality: Workflows, Transactions, and Runtime Controls"
+ description: Explore the workflow, transaction, and runtime controls that help AI agents operate safely across enterprise systems of record.
+ date: 2026-06-23 00:00:00 +0000
+ author_id: pruthvithej-ramesh-kumar
+ external: true
+ url: https://blogs.oracle.com/database/ai-agents-enterprise-reality-workflows-transactions-runtime-controls
+ tags:
+ - Agentic AI
+ - AI Agents
+ - Enterprise AI
+ - Production AI
+ - Oracle MicroTx Workflows
+ - Durable Execution
+ - Durable Workflows
+ - Human Approval
+ - Idempotency
+ - MCP
+ - RAG
+ - Runtime Controls
+ - Saga
+ - Systems of Record
+ - Transaction Coordination
+ - Workflow Orchestration
+ - XA
+ - TCC
+
+- title: Automating Invoice Processing with Oracle MicroTx Workflows
+ description: A practical look at automating invoice processing with Oracle MicroTx Workflows, from AI-assisted tasks through controlled approval and execution.
+ date: 2026-06-23 00:00:00 +0000
+ author_id: brijesh-deo
+ external: true
+ url: https://medium.com/@brijesh.deo/automating-invoice-processing-with-oracle-microtx-workflows-6bdb8cded310
+ tags:
+ - Oracle MicroTx Workflows
+ - Agentic Workflows
+ - AI-Assisted Workflows
+ - Human Approval
+ - Idempotency
+ - Oracle Database
+ - Workflow Orchestration
+
+- title: Oracle MicroTx 26.1 is now generally available
+ description: Discover Oracle MicroTx 26.1, combining durable workflow orchestration and distributed transaction coordination for resilient enterprise applications.
+ date: 2026-06-11 00:00:00 +0000
+ author_id: deepak-goel
+ external: true
+ url: https://blogs.oracle.com/database/oracle-microtx-26-1-is-now-generally-available
+ tags:
+ - Oracle MicroTx Workflows
+ - Durable Workflows
+ - Distributed Transactions
+ - Conductor OSS
+ - Oracle Database
+ - Agentic AI
+ - AI Agents
+ - MCP
+ - RAG
+ - Saga
+ - TCC
+ - XA
+ - Workflow Orchestration
+
+- title: Deploy MicroTx Workflow Server in OKE
+ description: Watch how to deploy the Oracle MicroTx Workflow Server on Oracle Kubernetes Engine.
+ date: 2026-08-11 00:00:00 +0000
+ author_id: shivanshu-singh
+ external: true
+ video: true
+ url: https://www.youtube.com/watch?v=2TyDIQy8F_U
+ tags:
+ - Oracle MicroTx Workflows
+ - OCI
+ - OKE
+ - Kubernetes
+ - Deployment
+ - Workflow Orchestration
+
+- title: Designing and Deploying Agentic Workflows with Distributed Transactions
+ description: Follow this Oracle LiveLabs workshop to design and deploy agentic workflows with Oracle MicroTx distributed transactions.
+ date: 2026-06-20 00:00:00 +0000
+ author_id: oracle-microtx-team
+ external: true
+ url: https://livelabs.oracle.com/ords/r/dbpm/livelabs/view-workshop?wid=4243
+ tags:
+ - Agentic AI
+ - Agentic Workflows
+ - Distributed Transactions
+ - Oracle MicroTx Workflows
+ - Workflow Orchestration
diff --git a/docs/_includes/article-card.html b/docs/_includes/article-card.html
new file mode 100644
index 00000000..68ce2d80
--- /dev/null
+++ b/docs/_includes/article-card.html
@@ -0,0 +1,21 @@
+{% assign article = include.article %}
+{% assign author = site.data.authors[article.author_id] %}
+
+ {% if article.image %}
+
+
+
+ {% endif %}
+
+
+ {% if article.video %}
Video{% endif %}
+ {% if author or article.author %}
By {{ author.name | default: article.author }}
{% endif %}
+
+
{{ article.description }}
+ {% if article.tags %}
+
+ {% endif %}
+
+
diff --git a/docs/_layouts/default.html b/docs/_layouts/default.html
new file mode 100644
index 00000000..877699b0
--- /dev/null
+++ b/docs/_layouts/default.html
@@ -0,0 +1,38 @@
+
+
+
+
+
+
+
+
+
+ {% feed_meta %}
+ {% seo %}
+
+
+
+ {{ content }}
+
+
+
+
+
diff --git a/docs/_layouts/post.html b/docs/_layouts/post.html
new file mode 100644
index 00000000..0bb7c262
--- /dev/null
+++ b/docs/_layouts/post.html
@@ -0,0 +1,20 @@
+---
+layout: default
+---
+
+ {% assign author = site.data.authors[page.author_id] %}
+
+ {{ content }}
+
+
diff --git a/docs/_posts/2026-08-10-deploy-microtx-free-oci-marketplace.md b/docs/_posts/2026-08-10-deploy-microtx-free-oci-marketplace.md
new file mode 100644
index 00000000..17dbcd9a
--- /dev/null
+++ b/docs/_posts/2026-08-10-deploy-microtx-free-oci-marketplace.md
@@ -0,0 +1,53 @@
+---
+title: Deploy Oracle MicroTx Free on OCI with Oracle Cloud Marketplace
+description: Provision a new Oracle Kubernetes Engine cluster and deploy MicroTx Free using the Oracle Cloud Marketplace Terraform stack.
+date: 2026-08-10
+updated: 2026-08-13
+author: BHARATH MC
+author_id: bharath-mc
+tags:
+ - MicroTx
+ - OCI
+ - OKE
+ - Oracle Cloud Marketplace
+ - Terraform
+---
+
+Oracle Cloud Marketplace provides a guided route to deploy Oracle MicroTx Free in Oracle Cloud Infrastructure (OCI). The Marketplace stack uses Terraform to provision the required OCI resources, create a new Oracle Kubernetes Engine (OKE) cluster, and deploy MicroTx to that cluster. It does not deploy to an existing OKE cluster.
+
+## Before you begin
+
+Prepare an OCI account with permissions to provision the required OCI resources, including a new OKE cluster and related networking. Complete the prerequisites and review the minimum resource requirements for the complete Terraform stack, including OKE worker nodes, the database, load balancer, file storage, and jump host.
+
+## Deploy from Marketplace
+
+1. Search Oracle Cloud Marketplace for **Oracle MicroTx**, then select Oracle MicroTx Free.
+2. Select **Get App**, then launch the supplied stack in OCI Resource Manager.
+3. Provide the stack inputs described below.
+4. Review the execution plan and apply the stack.
+5. Monitor the **Apply Job**. When it completes, use the stack outputs and deployment instructions to access MicroTx.
+
+## Stack inputs
+
+The Marketplace form groups the main inputs into the following sections. For field-level guidance and the complete provisioning procedure, use the official Oracle deployment guide.
+
+- **MicroTx Configurations:** Select the MicroTx version to install and enter a deployment name, which prefixes generated OCI resources. Enter a domain name for the MicroTx HTTPS hostname; the stack generates `.`, such as `microtx-demo.example.com`, and uses a self-signed certificate to secure TLS access to the endpoint.
+- **Database Configuration:** Connect MicroTx to your own Oracle Database, or have the stack provision an Oracle Autonomous AI Database in the FREE, DEVELOPER, or PAID edition.
+- **Workflow Server Secret:** Upload the `encryption.key` file used to encrypt and store sensitive Workflow Server data. Create the key by following the encryption-key prerequisites.
+- **Kubernetes Cluster Configurations:** Configure the worker node-pool name, autoscaling and its minimum and maximum worker-node counts, node instance shape, OCPUs, and memory.
+
+## Access MicroTx
+
+After the **Apply Job** completes, open its output values and complete the following steps:
+
+1. Copy the `hosts_entry` output, for example `129.xx.xx.xx microtx-demo.example.com`, to your local `/etc/hosts` file.
+2. Open the `launch_microtx` output URL, for example `https://microtx-demo.example.com/consoleui/`, to access the MicroTx Console UI.
+3. The stack uses a self-signed TLS certificate, so your browser might display a security warning. Accept the warning to continue to the Console UI.
+
+## Next steps
+
+Explore the MicroTx Workflow samples for workflow-based orchestration. For distributed transactions, use the XA, LRA, or TCC samples. Select the pattern that fits the consistency and compensation needs of your services. For the complete Marketplace procedure and every stack option, see the official Oracle deployment guide.
+
+### Also explore
+
+The quick-start documentation covers deployment paths for a local Minikube environment and an OKE cluster.
diff --git a/docs/assets/css/rouge.css b/docs/assets/css/rouge.css
new file mode 100644
index 00000000..2d0bfd8e
--- /dev/null
+++ b/docs/assets/css/rouge.css
@@ -0,0 +1,7 @@
+.highlight .c, .highlight .c1, .highlight .cm { color: #7f8c8d; }
+.highlight .k, .highlight .kd, .highlight .kn, .highlight .kp, .highlight .kr { color: #d35400; }
+.highlight .s, .highlight .s1, .highlight .s2, .highlight .sa, .highlight .sb { color: #2e7d32; }
+.highlight .m, .highlight .mi, .highlight .mf, .highlight .mh { color: #6a1b9a; }
+.highlight .nf, .highlight .nc, .highlight .nt { color: #1565c0; }
+.highlight .o, .highlight .p { color: #d4dbe3; }
+.highlight .na { color: #00838f; }
diff --git a/docs/assets/css/style.css b/docs/assets/css/style.css
new file mode 100644
index 00000000..16d20a4f
--- /dev/null
+++ b/docs/assets/css/style.css
@@ -0,0 +1,127 @@
+:root {
+ --ink: #242424;
+ --muted: #6b6b6b;
+ --line: #e6e6e6;
+ --surface: #fafafa;
+ --oracle-red: #c74634;
+ --link: #1a5e91;
+ --serif: Georgia, Cambria, "Times New Roman", Times, serif;
+ --sans: -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+}
+
+* { box-sizing: border-box; }
+
+body {
+ display: flex;
+ flex-direction: column;
+ min-height: 100vh;
+ margin: 0;
+ color: var(--ink);
+ background: #fff;
+ font: 16px/1.5 var(--sans);
+}
+
+a { color: var(--link); }
+
+.site-shell { width: min(100% - 2rem, 1100px); margin-inline: auto; }
+main.site-shell { flex: 1; }
+
+.site-header { border-top: 3px solid var(--oracle-red); border-bottom: 1px solid var(--line); background: #fff; }
+.header-content { display: flex; align-items: center; justify-content: space-between; gap: 1.5rem; min-height: 78px; }
+.brand { display: inline-flex; flex: 0 0 136px; align-items: center; height: 60px; overflow: hidden; text-decoration: none; }
+.site-header .brand img { display: block; width: 136px; height: 60px; max-width: none; object-fit: contain; }
+.brand-logo--dark { display: none !important; }
+[data-theme="dark"] .brand-logo--light { display: none !important; }
+[data-theme="dark"] .brand-logo--dark { display: block !important; }
+
+nav { display: flex; flex-wrap: wrap; gap: 1.35rem; align-items: center; }
+nav a, .theme-toggle { color: var(--ink); font: 500 .9rem/1 var(--sans); text-decoration: none; }
+nav a:hover { color: var(--oracle-red); }
+.theme-toggle { display: none; }
+
+.intro { max-width: 720px; padding: 2.3rem 0 1.2rem; }
+.eyebrow, .article-date { margin: 0; color: var(--muted); font: 600 .76rem/1.4 var(--sans); letter-spacing: .05em; text-transform: uppercase; }
+.intro p:not(.eyebrow) { margin: .55rem 0 0; color: var(--muted); font: 1rem/1.55 var(--sans); }
+
+.article-list { max-width: 900px; display: grid; gap: 1rem; padding: .4rem 0 4.5rem; }
+.article-card { overflow: hidden; border: 1px solid var(--line); border-radius: .45rem; background: #fff; box-shadow: 0 2px 8px rgb(29 39 51 / 5%); }
+.card-image { display: block; }
+.card-image img { display: block; width: 100%; aspect-ratio: 16 / 8; object-fit: cover; }
+.card-content { max-width: none; padding: 1.45rem 1.55rem; }
+.article-card .article-date { margin-bottom: .55rem; }
+.content-type { display: inline-flex; align-items: center; gap: .35rem; margin: 0 0 .45rem; color: var(--oracle-red); font: 700 .72rem/1 var(--sans); letter-spacing: .08em; text-transform: uppercase; }
+.content-type--video span { width: 0; height: 0; border-top: .3rem solid transparent; border-bottom: .3rem solid transparent; border-left: .44rem solid currentColor; }
+.card-author { margin: 0 0 .35rem; color: var(--muted); font: 600 .82rem/1.4 var(--sans); letter-spacing: .02em; }
+.article-card h2 { margin: 0; font: 700 clamp(1.45rem, 3vw, 1.85rem)/1.18 var(--sans); letter-spacing: -.025em; }
+.article-card h2 a { color: var(--ink); text-decoration: none; }
+.article-card h2 a:hover { color: var(--oracle-red); }
+.article-card p:not(.article-date) { margin: .55rem 0 0; color: var(--muted); font: 1rem/1.55 var(--sans); }
+
+.tags { display: flex; flex-wrap: wrap; gap: .45rem; margin: 1rem 0 0; padding: 0; list-style: none; }
+.tags li { padding: .12rem .5rem; border: 1px solid var(--line); border-radius: 999px; color: var(--muted); background: transparent; font: .78rem/1.35 var(--sans); }
+.tags a { color: inherit; text-decoration: none; }
+.tags a:hover { color: var(--oracle-red); }
+
+.post { width: min(100%, 700px); margin-inline: auto; padding: 4.8rem 0 5rem; }
+.post-header { padding-bottom: 1.7rem; }
+.post h1 { margin: 0; color: var(--ink); font: 700 clamp(2.1rem, 4.8vw, 3rem)/1.1 var(--sans); letter-spacing: -.04em; }
+.post-description { margin: 1.15rem 0 0; color: var(--muted); font: 1.3rem/1.45 var(--serif); }
+.post-meta { display: flex; flex-wrap: wrap; gap: .2rem 1rem; align-items: baseline; margin-top: 1.5rem; }
+.post-meta p { margin: 0; }
+.author { color: var(--ink); font: 500 .9rem/1.5 var(--sans); }
+.author a { color: inherit; }
+.post-meta .article-date { font-size: .73rem; }
+
+.post-content { margin-top: 1.2rem; font: 1.16rem/1.78 var(--serif); }
+.post-content > :first-child { margin-top: 0; }
+.post-content p, .post-content ul, .post-content ol { margin: 1.3rem 0; }
+.post-content li + li { margin-top: .45rem; }
+.post-content h2, .post-content h3 { color: var(--ink); font-family: var(--sans); line-height: 1.2; letter-spacing: -.025em; }
+.post-content h2 { margin: 3rem 0 1rem; font-size: 1.7rem; }
+.post-content h3 { margin: 2.2rem 0 .8rem; font-size: 1.28rem; }
+.post-content a { text-underline-offset: .14em; }
+.post-content img { display: block; max-width: 100%; height: auto; margin: 2rem 0; }
+.full-size-image { display: block; }
+.full-size-image img { cursor: zoom-in; }
+.post-content pre { position: relative; overflow-x: auto; margin: 1.8rem 0; padding: 1.35rem; border-radius: 0; background: #20252b; color: #f5f7f9; font: .84rem/1.65 ui-monospace, SFMono-Regular, Menlo, Consolas, monospace; }
+.post-content code { font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace; font-size: .84em; }
+.post-content :not(pre) > code { padding: .12em .3em; background: #f2f2f2; }
+.copy-code { position: absolute; top: .55rem; right: .55rem; padding: .22rem .55rem; border: 1px solid #69737e; border-radius: .25rem; color: #fff; background: #303841; cursor: pointer; font: .78rem/1 var(--sans); }
+.copy-code:hover { background: #47525d; }
+.video-embed { position: relative; width: 100%; margin: 2rem 0; padding-top: 56.25%; }
+.video-embed iframe { position: absolute; inset: 0; width: 100%; height: 100%; border: 0; }
+
+.article-footer { display: flex; flex-wrap: wrap; gap: 1.3rem; margin-top: 3.5rem; padding-top: 1.5rem; border-top: 1px solid var(--line); font: .9rem/1.5 var(--sans); }
+.article-footer a { color: var(--ink); }
+.article-footer a:hover { color: var(--oracle-red); }
+
+.tag-index { max-width: 720px; padding: 3.5rem 0 5rem; }
+.tag-index h1 { margin: .45rem 0 0; font: 700 clamp(2rem, 4vw, 3rem)/1.1 var(--sans); letter-spacing: -.035em; }
+.tag-section { margin-top: 2.6rem; }
+.tag-section h2 { margin-bottom: .65rem; font: 700 1.35rem/1.2 var(--sans); }
+.tag-section ul { margin: 0; padding-left: 1.2rem; }
+.tag-section li + li { margin-top: .5rem; }
+.tag-section span { margin-left: .55rem; color: var(--muted); font: .85rem var(--sans); }
+
+.site-footer { margin-top: auto; padding: 1.25rem 0; border-top: 1px solid var(--line); background: #fff; }
+.footer-links { display: flex; flex-wrap: wrap; gap: 1.15rem; }
+.footer-links a { color: var(--muted); font: .82rem/1.4 var(--sans); text-decoration: none; }
+.footer-links a:hover { color: var(--oracle-red); }
+
+@media (max-width: 620px) {
+ .site-shell { width: min(100% - 1.5rem, 1100px); }
+ .header-content { align-items: flex-start; flex-direction: column; padding: .9rem 0; }
+ nav { gap: 1rem; }
+ .intro { padding-top: 1.7rem; }
+ .card-content { padding: 1.25rem; }
+ .post { padding-top: 2.7rem; }
+ .post-content { font-size: 1.08rem; }
+ .post h1 { font-size: clamp(2rem, 9vw, 2.55rem); }
+}
+
+[data-theme="dark"] { --ink: #f5f5f5; --muted: #b4b4b4; --line: #3c3c3c; --surface: #171717; --link: #8acaff; }
+[data-theme="dark"] body, [data-theme="dark"] .site-header, [data-theme="dark"] .site-footer { background: #111; }
+[data-theme="dark"] .article-card { border-color: var(--line); }
+[data-theme="dark"] .article-card h2 a, [data-theme="dark"] nav a { color: var(--ink); }
+[data-theme="dark"] .tags li { color: #dedede; border-color: #4a4a4a; }
+[data-theme="dark"] .post-content :not(pre) > code { background: #292929; }
diff --git a/docs/assets/images/logo/oracle-microtx-black.png b/docs/assets/images/logo/oracle-microtx-black.png
new file mode 100644
index 00000000..86390dff
Binary files /dev/null and b/docs/assets/images/logo/oracle-microtx-black.png differ
diff --git a/docs/assets/images/logo/oracle-microtx-white.png b/docs/assets/images/logo/oracle-microtx-white.png
new file mode 100644
index 00000000..fd380c9f
Binary files /dev/null and b/docs/assets/images/logo/oracle-microtx-white.png differ
diff --git a/docs/assets/js/article-enhancements.js b/docs/assets/js/article-enhancements.js
new file mode 100644
index 00000000..bcec886f
--- /dev/null
+++ b/docs/assets/js/article-enhancements.js
@@ -0,0 +1,52 @@
+(function () {
+ document.querySelectorAll('a[href^="http"]').forEach(function (link) {
+ if (link.origin !== window.location.origin) {
+ link.target = '_blank';
+ link.rel = 'noopener noreferrer';
+ }
+ });
+
+ document.querySelectorAll('.post-content pre').forEach(function (pre) {
+ var button = document.createElement('button');
+ button.className = 'copy-code';
+ button.type = 'button';
+ button.textContent = 'Copy';
+ button.addEventListener('click', function () {
+ var code = pre.querySelector('code');
+ var text = code ? code.innerText : pre.innerText;
+ var copied = navigator.clipboard ? navigator.clipboard.writeText(text) : Promise.reject();
+ copied.catch(function () {
+ var textarea = document.createElement('textarea');
+ textarea.value = text;
+ textarea.style.position = 'fixed';
+ textarea.style.opacity = '0';
+ document.body.appendChild(textarea);
+ textarea.select();
+ document.execCommand('copy');
+ textarea.remove();
+ }).then(function () {
+ button.textContent = 'Copied';
+ setTimeout(function () { button.textContent = 'Copy'; }, 1500);
+ });
+ });
+ pre.appendChild(button);
+ });
+
+ document.querySelectorAll('.post-content img').forEach(function (image) {
+ if (!image.closest('a')) {
+ var link = document.createElement('a');
+ link.href = image.currentSrc || image.src;
+ link.className = 'full-size-image';
+ link.setAttribute('aria-label', 'View image at full size');
+ image.parentNode.insertBefore(link, image);
+ link.appendChild(image);
+ }
+ });
+
+ document.querySelectorAll('.post-content iframe[src*="youtube.com"], .post-content iframe[src*="youtu.be"]').forEach(function (iframe) {
+ var wrapper = document.createElement('div');
+ wrapper.className = 'video-embed';
+ iframe.parentNode.insertBefore(wrapper, iframe);
+ wrapper.appendChild(iframe);
+ });
+}());
diff --git a/docs/assets/js/theme-toggle.js b/docs/assets/js/theme-toggle.js
new file mode 100644
index 00000000..56d99502
--- /dev/null
+++ b/docs/assets/js/theme-toggle.js
@@ -0,0 +1,21 @@
+(function () {
+ var root = document.documentElement;
+ var toggle = document.querySelector('.theme-toggle');
+
+ if (!toggle) return;
+
+ function render() {
+ var isDark = root.dataset.theme === 'dark';
+ toggle.setAttribute('aria-pressed', String(isDark));
+ toggle.textContent = isDark ? 'Light theme' : 'Dark theme';
+ toggle.setAttribute('aria-label', isDark ? 'Switch to light theme' : 'Switch to dark theme');
+ }
+
+ toggle.addEventListener('click', function () {
+ root.dataset.theme = root.dataset.theme === 'dark' ? 'light' : 'dark';
+ try { localStorage.setItem('microtx-theme', root.dataset.theme); } catch (error) {}
+ render();
+ });
+
+ render();
+}());
diff --git a/docs/google13dba951707f5edb.html b/docs/google13dba951707f5edb.html
new file mode 100644
index 00000000..dea675d2
--- /dev/null
+++ b/docs/google13dba951707f5edb.html
@@ -0,0 +1 @@
+google-site-verification: google13dba951707f5edb.html
\ No newline at end of file
diff --git a/docs/index.html b/docs/index.html
new file mode 100644
index 00000000..940cb5ec
--- /dev/null
+++ b/docs/index.html
@@ -0,0 +1,16 @@
+---
+layout: default
+title: "Oracle MicroTx Blog: Workflows & Distributed Transactions"
+description: Oracle MicroTx tutorials and deployment guides for durable workflows and XA, LRA, and TCC distributed transactions on Oracle Database, OCI, OKE, and Oracle Cloud Marketplace.
+---
+
+ Oracle MicroTx Blog
+ Deployment guidance, distributed-transaction patterns, Workflow Orchestration and examples for Oracle MicroTx.
+
+
+
+ {% assign articles = site.posts | concat: site.data.external_articles | sort: "date" | reverse %}
+ {% for article in articles %}
+ {% include article-card.html article=article %}
+ {% endfor %}
+
diff --git a/docs/llms.txt b/docs/llms.txt
new file mode 100644
index 00000000..cce905cc
--- /dev/null
+++ b/docs/llms.txt
@@ -0,0 +1,15 @@
+# Oracle MicroTx Blog
+
+> Technical articles, deployment guides, and workflow resources for Oracle Transaction Manager for Microservices (Oracle MicroTx).
+
+## Primary resources
+
+- [Oracle MicroTx Blog](https://oracle-samples.github.io/microtx-samples/): Oracle MicroTx tutorials, deployment guides, durable workflow orchestration, and distributed transaction patterns.
+- [Deploy Oracle MicroTx Free on OCI with Oracle Cloud Marketplace](https://oracle-samples.github.io/microtx-samples/deploy-microtx-free-oci-marketplace/): Deploy MicroTx Free on Oracle Kubernetes Engine using the Oracle Cloud Marketplace Terraform stack.
+- [MicroTx quickstart](https://oracle-samples.github.io/microtx-samples/quickstart/): Local Minikube and Oracle Kubernetes Engine quickstart resources.
+- [Oracle MicroTx documentation](https://docs.oracle.com/en/database/oracle/transaction-manager-for-microservices/26.1/): Official Oracle documentation.
+- [MicroTx sample applications repository](https://github.com/oracle-samples/microtx-samples): Source code and sample applications.
+
+## Topics
+
+Oracle MicroTx, Oracle Transaction Manager for Microservices, durable workflows, workflow orchestration, distributed transactions, XA, LRA, TCC, Oracle Database, Oracle Cloud Infrastructure, Oracle Kubernetes Engine, and Oracle Cloud Marketplace.
diff --git a/docs/robots.txt b/docs/robots.txt
new file mode 100644
index 00000000..30278395
--- /dev/null
+++ b/docs/robots.txt
@@ -0,0 +1,8 @@
+---
+layout: null
+---
+User-agent: *
+Allow: /
+
+# Search engines and AI search crawlers may access this public site.
+Sitemap: {{ '/sitemap.xml' | absolute_url }}
diff --git a/docs/tags/index.html b/docs/tags/index.html
new file mode 100644
index 00000000..96182453
--- /dev/null
+++ b/docs/tags/index.html
@@ -0,0 +1,28 @@
+---
+layout: default
+title: Tags
+description: Browse Oracle MicroTx articles by topic.
+---
+
+ Browse by topic
+
+ {% assign all_tags = '' | split: '' %}
+ {% for post in site.posts %}{% assign all_tags = all_tags | concat: post.tags %}{% endfor %}
+ {% for article in site.data.external_articles %}{% assign all_tags = all_tags | concat: article.tags %}{% endfor %}
+ {% assign sorted_tags = all_tags | uniq | sort %}
+ {% for tag in sorted_tags %}
+
+ {{ tag }}
+
+ {% for post in site.tags[tag] %}
+ - {{ post.title }}{{ post.date | date: "%B %-d, %Y" }}
+ {% endfor %}
+ {% for article in site.data.external_articles %}
+ {% if article.tags contains tag %}
+ - {{ article.title }}{{ article.date | date: "%B %-d, %Y" }}
+ {% endif %}
+ {% endfor %}
+
+
+ {% endfor %}
+