From e07e150d9a85a86806fcabd54cfa68a5c7270314 Mon Sep 17 00:00:00 2001
From: Artur Shiriev <lesnik512@gmail.com>
Date: Sun, 5 Jul 2026 00:49:08 +0300
Subject: [PATCH] docs: add project lockup hero to home page

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 docs/assets/lockup-dark.svg  |  1 +
 docs/assets/lockup-light.svg |  1 +
 docs/css/brand.css           | 20 ++++++++++++++++++++
 docs/index.md                |  9 ++++++++-
 4 files changed, 30 insertions(+), 1 deletion(-)
 create mode 100644 docs/assets/lockup-dark.svg
 create mode 100644 docs/assets/lockup-light.svg

diff --git a/docs/assets/lockup-dark.svg b/docs/assets/lockup-dark.svg
new file mode 100644
index 0000000..bf0970b
--- /dev/null
+++ b/docs/assets/lockup-dark.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 382 100" role="img" aria-label="faststream-outbox"><g><path d="M9 62 L9 9 L62 9" fill="none" stroke="#f4f1e8" stroke-width="11" stroke-linejoin="miter"/><rect x="55.0" y="2.0" width="14" height="14" rx="2" fill="#f4f1e8"/><polygon points="3.5,60.0 14.5,60.0 14.5,62.0 3.5,73.0" fill="#f4f1e8"/><path d="M91 38 L91 91 L38 91" fill="none" stroke="#f0b528" stroke-width="11" stroke-linejoin="miter"/><rect x="31.0" y="84.0" width="14" height="14" rx="2" fill="#f0b528"/><polygon points="96.5,40.0 85.5,40.0 85.5,38.0 96.5,27.0" fill="#f0b528"/><ellipse cx="43.56" cy="50.5" rx="8.3" ry="2.6" fill="#f0b528"/><rect x="35.3" y="50.5" width="16.6" height="11.9" fill="#f0b528"/><ellipse cx="43.56" cy="62.4" rx="8.3" ry="2.6" fill="#f0b528"/><ellipse cx="43.56" cy="50.5" rx="8.3" ry="2.6" fill="none" stroke="#f4f1e8" stroke-width="0.8"/><circle cx="50.0" cy="49.5" r="3.0" fill="#f0b528"/><path d="M58.3 49.5 A 8.3 8.3 0 0 0 50.0 41.3" fill="none" stroke="#f0b528" stroke-width="2.3"/><path d="M63.6 49.5 A 13.6 13.6 0 0 0 50.0 36.0" fill="none" stroke="#f0b528" stroke-width="2.3"/><path d="M68.9 49.5 A 18.9 18.9 0 0 0 50.0 30.7" fill="none" stroke="#f0b528" stroke-width="2.3"/></g><g fill="#f4f1e8" transform="translate(118.000,61.560) scale(0.034000,-0.034000)"><path d="M40 460V385H270V460ZM262 684 306 750Q299 760 286.5 769.0Q274 778 257.0 784.0Q240 790 218 790Q176 790 146.5 772.5Q117 755 101.0 720.0Q85 685 85 630V0H165V620Q165 653 171.0 673.0Q177 693 187.5 701.5Q198 710 213 710Q225 710 238.5 705.5Q252 701 262 684Z" transform="translate(0.00,0)"/><path d="M111 142Q111 167 123.0 185.0Q135 203 159.5 213.0Q184 223 223 223Q265 223 302.0 212.5Q339 202 374 178V225Q367 234 347.0 248.5Q327 263 293.5 274.5Q260 286 210 286Q125 286 77.5 245.5Q30 205 30 138Q30 91 52.0 58.0Q74 25 110.5 7.5Q147 -10 189 -10Q227 -10 265.5 4.0Q304 18 330.5 47.0Q357 76 357 120L341 180Q341 144 323.5 116.5Q306 89 276.5 74.0Q247 59 210 59Q181 59 158.5 68.5Q136 78 123.5 97.0Q111 116 111 142ZM99 354Q110 362 129.0 373.0Q148 384 175.5 392.0Q203 400 237 400Q258 400 277.0 396.0Q296 392 310.5 383.0Q325 374 333.0 358.5Q341 343 341 319V0H421V330Q421 375 398.5 406.0Q376 437 335.5 453.5Q295 470 241 470Q177 470 131.5 451.0Q86 432 60 413Z" transform="translate(286.00,0)"/><path d="M94 141 31 102Q44 75 69.5 49.0Q95 23 132.0 6.5Q169 -10 215 -10Q286 -10 329.5 30.0Q373 70 373 130Q373 171 353.5 197.0Q334 223 301.0 241.5Q268 260 228 276Q204 286 182.0 297.0Q160 308 146.0 322.0Q132 336 132 354Q132 377 150.0 388.0Q168 399 193 399Q229 399 257.5 382.0Q286 365 305 339L369 380Q355 406 330.0 426.0Q305 446 272.5 458.0Q240 470 203 470Q166 470 131.5 457.0Q97 444 75.5 417.0Q54 390 54 349Q54 309 74.5 282.5Q95 256 125.5 239.5Q156 223 186 211Q213 201 237.0 189.5Q261 178 276.5 161.5Q292 145 292 121Q292 94 272.5 78.5Q253 63 219 63Q191 63 167.5 73.5Q144 84 126.0 102.0Q108 120 94 141Z" transform="translate(767.00,0)"/><path d="M5 460V385H235V460ZM80 620V0H160V620Z" transform="translate(1170.00,0)"/><path d="M94 141 31 102Q44 75 69.5 49.0Q95 23 132.0 6.5Q169 -10 215 -10Q286 -10 329.5 30.0Q373 70 373 130Q373 171 353.5 197.0Q334 223 301.0 241.5Q268 260 228 276Q204 286 182.0 297.0Q160 308 146.0 322.0Q132 336 132 354Q132 377 150.0 388.0Q168 399 193 399Q229 399 257.5 382.0Q286 365 305 339L369 380Q355 406 330.0 426.0Q305 446 272.5 458.0Q240 470 203 470Q166 470 131.5 457.0Q97 444 75.5 417.0Q54 390 54 349Q54 309 74.5 282.5Q95 256 125.5 239.5Q156 223 186 211Q213 201 237.0 189.5Q261 178 276.5 161.5Q292 145 292 121Q292 94 272.5 78.5Q253 63 219 63Q191 63 167.5 73.5Q144 84 126.0 102.0Q108 120 94 141Z" transform="translate(1410.00,0)"/><path d="M5 460V385H235V460ZM80 620V0H160V620Z" transform="translate(1813.00,0)"/><path d="M155 460H75V0H155ZM294 372 338 438Q320 457 298.5 463.5Q277 470 252 470Q220 470 189.0 445.0Q158 420 138.5 377.5Q119 335 119 280H155Q155 313 161.5 339.0Q168 365 185.0 380.0Q202 395 232 395Q252 395 265.0 389.5Q278 384 294 372Z" transform="translate(2053.00,0)"/><path d="M253 -10Q327 -10 381.5 19.5Q436 49 472 107L407 148Q382 106 346.0 85.5Q310 65 263 65Q216 65 183.0 85.0Q150 105 133.0 143.0Q116 181 116 235Q117 288 134.5 324.5Q152 361 184.5 380.5Q217 400 263 400Q302 400 331.0 383.0Q360 366 376.5 336.0Q393 306 393 265Q393 258 390.0 247.5Q387 237 384 232L416 278H86V210H479Q479 212 479.5 219.5Q480 227 480 234Q480 307 454.0 360.0Q428 413 379.5 441.5Q331 470 263 470Q195 470 143.5 440.0Q92 410 63.5 356.0Q35 302 35 230Q35 159 62.5 105.0Q90 51 139.5 20.5Q189 -10 253 -10Z" transform="translate(2396.00,0)"/><path d="M111 142Q111 167 123.0 185.0Q135 203 159.5 213.0Q184 223 223 223Q265 223 302.0 212.5Q339 202 374 178V225Q367 234 347.0 248.5Q327 263 293.5 274.5Q260 286 210 286Q125 286 77.5 245.5Q30 205 30 138Q30 91 52.0 58.0Q74 25 110.5 7.5Q147 -10 189 -10Q227 -10 265.5 4.0Q304 18 330.5 47.0Q357 76 357 120L341 180Q341 144 323.5 116.5Q306 89 276.5 74.0Q247 59 210 59Q181 59 158.5 68.5Q136 78 123.5 97.0Q111 116 111 142ZM99 354Q110 362 129.0 373.0Q148 384 175.5 392.0Q203 400 237 400Q258 400 277.0 396.0Q296 392 310.5 383.0Q325 374 333.0 358.5Q341 343 341 319V0H421V330Q421 375 398.5 406.0Q376 437 335.5 453.5Q295 470 241 470Q177 470 131.5 451.0Q86 432 60 413Z" transform="translate(2911.00,0)"/><path d="M705 290Q705 347 687.5 387.5Q670 428 637.0 449.0Q604 470 557 470Q511 470 475.0 448.5Q439 427 415 384Q399 425 364.5 447.5Q330 470 282 470Q239 470 207.5 451.0Q176 432 155 393V460H75V0H155V280Q155 316 168.0 342.0Q181 368 205.0 381.5Q229 395 262 395Q307 395 328.5 367.0Q350 339 350 280V0H430V280Q430 316 443.0 342.0Q456 368 480.0 381.5Q504 395 537 395Q582 395 603.5 367.0Q625 339 625 280V0H705Z" transform="translate(3392.00,0)"/><path d="M5 200H205V275H5Z" transform="translate(4172.00,0)"/><path d="M35 230Q35 161 66.5 106.5Q98 52 152.0 21.0Q206 -10 273 -10Q341 -10 394.5 21.0Q448 52 479.5 106.5Q511 161 511 230Q511 300 479.5 354.0Q448 408 394.5 439.0Q341 470 273 470Q206 470 152.0 439.0Q98 408 66.5 354.0Q35 300 35 230ZM116 230Q116 278 136.5 315.5Q157 353 192.5 374.0Q228 395 273 395Q318 395 353.5 374.0Q389 353 409.5 315.5Q430 278 430 230Q430 182 409.5 145.0Q389 108 353.5 86.5Q318 65 273 65Q228 65 192.5 86.5Q157 108 136.5 145.0Q116 182 116 230Z" transform="translate(4382.00,0)"/><path d="M155 180V460H75V170Q75 88 118.0 39.0Q161 -10 233 -10Q279 -10 313.0 10.5Q347 31 370 72V0H450V460H370V180Q370 146 355.5 120.0Q341 94 314.5 79.5Q288 65 253 65Q205 65 180.0 95.0Q155 125 155 180Z" transform="translate(4928.00,0)"/><path d="M5 460V385H235V460ZM80 620V0H160V620Z" transform="translate(5453.00,0)"/><path d="M150 780H70V0H150ZM535 230Q535 305 504.0 358.5Q473 412 421.5 441.0Q370 470 307 470Q250 470 206.5 441.0Q163 412 138.5 358.5Q114 305 114 230Q114 156 138.5 102.0Q163 48 206.5 19.0Q250 -10 307 -10Q370 -10 421.5 19.0Q473 48 504.0 102.0Q535 156 535 230ZM454 230Q454 177 432.5 140.0Q411 103 375.5 84.0Q340 65 297 65Q262 65 228.0 84.0Q194 103 172.0 140.0Q150 177 150 230Q150 283 172.0 320.0Q194 357 228.0 376.0Q262 395 297 395Q340 395 375.5 376.0Q411 357 432.5 320.0Q454 283 454 230Z" transform="translate(5693.00,0)"/><path d="M35 230Q35 161 66.5 106.5Q98 52 152.0 21.0Q206 -10 273 -10Q341 -10 394.5 21.0Q448 52 479.5 106.5Q511 161 511 230Q511 300 479.5 354.0Q448 408 394.5 439.0Q341 470 273 470Q206 470 152.0 439.0Q98 408 66.5 354.0Q35 300 35 230ZM116 230Q116 278 136.5 315.5Q157 353 192.5 374.0Q228 395 273 395Q318 395 353.5 374.0Q389 353 409.5 315.5Q430 278 430 230Q430 182 409.5 145.0Q389 108 353.5 86.5Q318 65 273 65Q228 65 192.5 86.5Q157 108 136.5 145.0Q116 182 116 230Z" transform="translate(6263.00,0)"/><path d="M320 460 210 300 100 460H10L167 237L0 0H90L210 174L330 0H420L253 237L410 460Z" transform="translate(6809.00,0)"/></g></svg>
diff --git a/docs/assets/lockup-light.svg b/docs/assets/lockup-light.svg
new file mode 100644
index 0000000..a5f9ac9
--- /dev/null
+++ b/docs/assets/lockup-light.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 382 100" role="img" aria-label="faststream-outbox"><g><path d="M9 62 L9 9 L62 9" fill="none" stroke="#356852" stroke-width="11" stroke-linejoin="miter"/><rect x="55.0" y="2.0" width="14" height="14" rx="2" fill="#356852"/><polygon points="3.5,60.0 14.5,60.0 14.5,62.0 3.5,73.0" fill="#356852"/><path d="M91 38 L91 91 L38 91" fill="none" stroke="#c98a00" stroke-width="11" stroke-linejoin="miter"/><rect x="31.0" y="84.0" width="14" height="14" rx="2" fill="#c98a00"/><polygon points="96.5,40.0 85.5,40.0 85.5,38.0 96.5,27.0" fill="#c98a00"/><ellipse cx="43.56" cy="50.5" rx="8.3" ry="2.6" fill="#c98a00"/><rect x="35.3" y="50.5" width="16.6" height="11.9" fill="#c98a00"/><ellipse cx="43.56" cy="62.4" rx="8.3" ry="2.6" fill="#c98a00"/><ellipse cx="43.56" cy="50.5" rx="8.3" ry="2.6" fill="none" stroke="#f4f1e8" stroke-width="0.8"/><circle cx="50.0" cy="49.5" r="3.0" fill="#c98a00"/><path d="M58.3 49.5 A 8.3 8.3 0 0 0 50.0 41.3" fill="none" stroke="#c98a00" stroke-width="2.3"/><path d="M63.6 49.5 A 13.6 13.6 0 0 0 50.0 36.0" fill="none" stroke="#c98a00" stroke-width="2.3"/><path d="M68.9 49.5 A 18.9 18.9 0 0 0 50.0 30.7" fill="none" stroke="#c98a00" stroke-width="2.3"/></g><g fill="#356852" transform="translate(118.000,61.560) scale(0.034000,-0.034000)"><path d="M40 460V385H270V460ZM262 684 306 750Q299 760 286.5 769.0Q274 778 257.0 784.0Q240 790 218 790Q176 790 146.5 772.5Q117 755 101.0 720.0Q85 685 85 630V0H165V620Q165 653 171.0 673.0Q177 693 187.5 701.5Q198 710 213 710Q225 710 238.5 705.5Q252 701 262 684Z" transform="translate(0.00,0)"/><path d="M111 142Q111 167 123.0 185.0Q135 203 159.5 213.0Q184 223 223 223Q265 223 302.0 212.5Q339 202 374 178V225Q367 234 347.0 248.5Q327 263 293.5 274.5Q260 286 210 286Q125 286 77.5 245.5Q30 205 30 138Q30 91 52.0 58.0Q74 25 110.5 7.5Q147 -10 189 -10Q227 -10 265.5 4.0Q304 18 330.5 47.0Q357 76 357 120L341 180Q341 144 323.5 116.5Q306 89 276.5 74.0Q247 59 210 59Q181 59 158.5 68.5Q136 78 123.5 97.0Q111 116 111 142ZM99 354Q110 362 129.0 373.0Q148 384 175.5 392.0Q203 400 237 400Q258 400 277.0 396.0Q296 392 310.5 383.0Q325 374 333.0 358.5Q341 343 341 319V0H421V330Q421 375 398.5 406.0Q376 437 335.5 453.5Q295 470 241 470Q177 470 131.5 451.0Q86 432 60 413Z" transform="translate(286.00,0)"/><path d="M94 141 31 102Q44 75 69.5 49.0Q95 23 132.0 6.5Q169 -10 215 -10Q286 -10 329.5 30.0Q373 70 373 130Q373 171 353.5 197.0Q334 223 301.0 241.5Q268 260 228 276Q204 286 182.0 297.0Q160 308 146.0 322.0Q132 336 132 354Q132 377 150.0 388.0Q168 399 193 399Q229 399 257.5 382.0Q286 365 305 339L369 380Q355 406 330.0 426.0Q305 446 272.5 458.0Q240 470 203 470Q166 470 131.5 457.0Q97 444 75.5 417.0Q54 390 54 349Q54 309 74.5 282.5Q95 256 125.5 239.5Q156 223 186 211Q213 201 237.0 189.5Q261 178 276.5 161.5Q292 145 292 121Q292 94 272.5 78.5Q253 63 219 63Q191 63 167.5 73.5Q144 84 126.0 102.0Q108 120 94 141Z" transform="translate(767.00,0)"/><path d="M5 460V385H235V460ZM80 620V0H160V620Z" transform="translate(1170.00,0)"/><path d="M94 141 31 102Q44 75 69.5 49.0Q95 23 132.0 6.5Q169 -10 215 -10Q286 -10 329.5 30.0Q373 70 373 130Q373 171 353.5 197.0Q334 223 301.0 241.5Q268 260 228 276Q204 286 182.0 297.0Q160 308 146.0 322.0Q132 336 132 354Q132 377 150.0 388.0Q168 399 193 399Q229 399 257.5 382.0Q286 365 305 339L369 380Q355 406 330.0 426.0Q305 446 272.5 458.0Q240 470 203 470Q166 470 131.5 457.0Q97 444 75.5 417.0Q54 390 54 349Q54 309 74.5 282.5Q95 256 125.5 239.5Q156 223 186 211Q213 201 237.0 189.5Q261 178 276.5 161.5Q292 145 292 121Q292 94 272.5 78.5Q253 63 219 63Q191 63 167.5 73.5Q144 84 126.0 102.0Q108 120 94 141Z" transform="translate(1410.00,0)"/><path d="M5 460V385H235V460ZM80 620V0H160V620Z" transform="translate(1813.00,0)"/><path d="M155 460H75V0H155ZM294 372 338 438Q320 457 298.5 463.5Q277 470 252 470Q220 470 189.0 445.0Q158 420 138.5 377.5Q119 335 119 280H155Q155 313 161.5 339.0Q168 365 185.0 380.0Q202 395 232 395Q252 395 265.0 389.5Q278 384 294 372Z" transform="translate(2053.00,0)"/><path d="M253 -10Q327 -10 381.5 19.5Q436 49 472 107L407 148Q382 106 346.0 85.5Q310 65 263 65Q216 65 183.0 85.0Q150 105 133.0 143.0Q116 181 116 235Q117 288 134.5 324.5Q152 361 184.5 380.5Q217 400 263 400Q302 400 331.0 383.0Q360 366 376.5 336.0Q393 306 393 265Q393 258 390.0 247.5Q387 237 384 232L416 278H86V210H479Q479 212 479.5 219.5Q480 227 480 234Q480 307 454.0 360.0Q428 413 379.5 441.5Q331 470 263 470Q195 470 143.5 440.0Q92 410 63.5 356.0Q35 302 35 230Q35 159 62.5 105.0Q90 51 139.5 20.5Q189 -10 253 -10Z" transform="translate(2396.00,0)"/><path d="M111 142Q111 167 123.0 185.0Q135 203 159.5 213.0Q184 223 223 223Q265 223 302.0 212.5Q339 202 374 178V225Q367 234 347.0 248.5Q327 263 293.5 274.5Q260 286 210 286Q125 286 77.5 245.5Q30 205 30 138Q30 91 52.0 58.0Q74 25 110.5 7.5Q147 -10 189 -10Q227 -10 265.5 4.0Q304 18 330.5 47.0Q357 76 357 120L341 180Q341 144 323.5 116.5Q306 89 276.5 74.0Q247 59 210 59Q181 59 158.5 68.5Q136 78 123.5 97.0Q111 116 111 142ZM99 354Q110 362 129.0 373.0Q148 384 175.5 392.0Q203 400 237 400Q258 400 277.0 396.0Q296 392 310.5 383.0Q325 374 333.0 358.5Q341 343 341 319V0H421V330Q421 375 398.5 406.0Q376 437 335.5 453.5Q295 470 241 470Q177 470 131.5 451.0Q86 432 60 413Z" transform="translate(2911.00,0)"/><path d="M705 290Q705 347 687.5 387.5Q670 428 637.0 449.0Q604 470 557 470Q511 470 475.0 448.5Q439 427 415 384Q399 425 364.5 447.5Q330 470 282 470Q239 470 207.5 451.0Q176 432 155 393V460H75V0H155V280Q155 316 168.0 342.0Q181 368 205.0 381.5Q229 395 262 395Q307 395 328.5 367.0Q350 339 350 280V0H430V280Q430 316 443.0 342.0Q456 368 480.0 381.5Q504 395 537 395Q582 395 603.5 367.0Q625 339 625 280V0H705Z" transform="translate(3392.00,0)"/><path d="M5 200H205V275H5Z" transform="translate(4172.00,0)"/><path d="M35 230Q35 161 66.5 106.5Q98 52 152.0 21.0Q206 -10 273 -10Q341 -10 394.5 21.0Q448 52 479.5 106.5Q511 161 511 230Q511 300 479.5 354.0Q448 408 394.5 439.0Q341 470 273 470Q206 470 152.0 439.0Q98 408 66.5 354.0Q35 300 35 230ZM116 230Q116 278 136.5 315.5Q157 353 192.5 374.0Q228 395 273 395Q318 395 353.5 374.0Q389 353 409.5 315.5Q430 278 430 230Q430 182 409.5 145.0Q389 108 353.5 86.5Q318 65 273 65Q228 65 192.5 86.5Q157 108 136.5 145.0Q116 182 116 230Z" transform="translate(4382.00,0)"/><path d="M155 180V460H75V170Q75 88 118.0 39.0Q161 -10 233 -10Q279 -10 313.0 10.5Q347 31 370 72V0H450V460H370V180Q370 146 355.5 120.0Q341 94 314.5 79.5Q288 65 253 65Q205 65 180.0 95.0Q155 125 155 180Z" transform="translate(4928.00,0)"/><path d="M5 460V385H235V460ZM80 620V0H160V620Z" transform="translate(5453.00,0)"/><path d="M150 780H70V0H150ZM535 230Q535 305 504.0 358.5Q473 412 421.5 441.0Q370 470 307 470Q250 470 206.5 441.0Q163 412 138.5 358.5Q114 305 114 230Q114 156 138.5 102.0Q163 48 206.5 19.0Q250 -10 307 -10Q370 -10 421.5 19.0Q473 48 504.0 102.0Q535 156 535 230ZM454 230Q454 177 432.5 140.0Q411 103 375.5 84.0Q340 65 297 65Q262 65 228.0 84.0Q194 103 172.0 140.0Q150 177 150 230Q150 283 172.0 320.0Q194 357 228.0 376.0Q262 395 297 395Q340 395 375.5 376.0Q411 357 432.5 320.0Q454 283 454 230Z" transform="translate(5693.00,0)"/><path d="M35 230Q35 161 66.5 106.5Q98 52 152.0 21.0Q206 -10 273 -10Q341 -10 394.5 21.0Q448 52 479.5 106.5Q511 161 511 230Q511 300 479.5 354.0Q448 408 394.5 439.0Q341 470 273 470Q206 470 152.0 439.0Q98 408 66.5 354.0Q35 300 35 230ZM116 230Q116 278 136.5 315.5Q157 353 192.5 374.0Q228 395 273 395Q318 395 353.5 374.0Q389 353 409.5 315.5Q430 278 430 230Q430 182 409.5 145.0Q389 108 353.5 86.5Q318 65 273 65Q228 65 192.5 86.5Q157 108 136.5 145.0Q116 182 116 230Z" transform="translate(6263.00,0)"/><path d="M320 460 210 300 100 460H10L167 237L0 0H90L210 174L330 0H420L253 237L410 460Z" transform="translate(6809.00,0)"/></g></svg>
diff --git a/docs/css/brand.css b/docs/css/brand.css
index 5c95b6f..df52168 100644
--- a/docs/css/brand.css
+++ b/docs/css/brand.css
@@ -15,3 +15,23 @@
   --md-accent-fg-color:         #e0a300;
   --md-typeset-a-color:         #7fb79f;
 }
+
+/* Centered project lockup hero on the docs home page */
+.mp-hero {
+  text-align: center;
+  margin: 1.5rem 0 2.5rem;
+}
+.mp-hero .mp-lockup {
+  margin: 0;
+  font-size: 0;   /* collapse whitespace between the stacked <img> variants */
+  line-height: 0;
+}
+.mp-hero .mp-logo {
+  max-width: 420px;
+  width: 70%;
+  height: auto;
+}
+/* Light lockup by default; cream lockup in dark (slate) mode. */
+.mp-hero .mp-logo--dark { display: none; }
+[data-md-color-scheme="slate"] .mp-hero .mp-logo--light { display: none; }
+[data-md-color-scheme="slate"] .mp-hero .mp-logo--dark  { display: inline; }
diff --git a/docs/index.md b/docs/index.md
index 0ce3502..4ca7aaf 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -1,4 +1,11 @@
-# faststream-outbox
+<div class="mp-hero" markdown>
+
+<h1 class="mp-lockup">
+<img class="mp-logo mp-logo--light" src="assets/lockup-light.svg" alt="faststream-outbox">
+<img class="mp-logo mp-logo--dark" src="assets/lockup-dark.svg" alt="" aria-hidden="true">
+</h1>
+
+</div>
 
 `faststream-outbox` is a [FastStream](https://faststream.airt.ai) broker
 integration for the **transactional outbox pattern** — a Postgres table is