aural-ui 3.0.6 → 4.0.1

package/dist/icons/site-logo-icon/SiteLogoIcon.stories.tsx

@@ -11,9 +11,9 @@ const meta: Meta<typeof SiteLogoIcon> = {
     backgrounds: {
       default: "dark",
       values: [
-        { name: "dark", value: "#0a0a0a" },
-        { name: "darker", value: "#000000" },
-        { name: "light", value: "#ffffff" },
+        { name: "dark", value: "var(--color-fm-surface-primary)" },
+        { name: "darker", value: "var(--color-fm-neutral-0)" },
+        { name: "light", value: "var(--color-fm-neutral-1100)" },
       ],
     },
     docs: {
@@ -40,42 +40,42 @@ const meta: Meta<typeof SiteLogoIcon> = {
                 background: transparent !important;
               }
               body {
-                background: #0a0a0a !important;
+                background: var(--color-fm-surface-primary) !important;
               }
               #storybook-docs {
-                background: #0a0a0a !important;
+                background: var(--color-fm-surface-primary) !important;
               }
               .sbdocs-preview {
                 background: transparent !important;
                 border: none !important;
               }
               .sbdocs-h1, .sbdocs-h2, .sbdocs-h3, .sbdocs-h4, .sbdocs-h5, .sbdocs-h6 {
-                color: white !important;
+                color: var(--color-fm-icon-active) !important;
               }
               .sbdocs-p, .sbdocs-li {
-                color: rgba(255, 255, 255, 0.7) !important;
+                color: var(--color-fm-secondary) !important;
               }
               .sbdocs-code {
-                background: rgba(255, 255, 255, 0.1) !important;
-                color: rgba(168, 85, 247, 1) !important;
-                border: 1px solid rgba(255, 255, 255, 0.1) !important;
+                background: var(--color-fm-surface-secondary) !important;
+                color: var(--color-fm-secondary-500) !important;
+                border: 1px solid var(--color-fm-divider-secondary) !important;
               }
               .sbdocs-pre {
-                background: rgba(0, 0, 0, 0.4) !important;
-                border: 1px solid rgba(255, 255, 255, 0.1) !important;
+                background: var(--color-fm-surface-secondary) !important;
+                border: 1px solid var(--color-fm-divider-secondary) !important;
               }
               .sbdocs-table {
-                background: rgba(255, 255, 255, 0.05) !important;
-                border: 1px solid rgba(255, 255, 255, 0.1) !important;
+                background: var(--color-fm-surface-secondary) !important;
+                border: 1px solid var(--color-fm-divider-secondary) !important;
               }
               .sbdocs-table th {
-                background: rgba(255, 255, 255, 0.05) !important;
-                color: white !important;
-                border-bottom: 1px solid rgba(255, 255, 255, 0.1) !important;
+                background: var(--color-fm-surface-secondary) !important;
+                color: var(--color-fm-icon-active) !important;
+                border-bottom: 1px solid var(--color-fm-divider-secondary) !important;
               }
               .sbdocs-table td {
-                color: rgba(255, 255, 255, 0.7) !important;
-                border-bottom: 1px solid rgba(255, 255, 255, 0.05) !important;
+                color: var(--color-fm-secondary) !important;
+                border-bottom: 1px solid var(--color-fm-divider-tertiary) !important;
               }
               @keyframes logo-pulse {
                 0%, 100% { transform: scale(1); }
@@ -94,19 +94,19 @@ const meta: Meta<typeof SiteLogoIcon> = {
             `}
           </style>
 
-          <div className="min-h-screen bg-gradient-to-br from-gray-900 via-red-900/20 to-gray-900">
+          <div className="from-fm-surface-primary via-fm-icon-negative/5 to-fm-surface-primary min-h-screen bg-linear-to-br">
             {/* Header */}
-            <div className="relative overflow-hidden border-b border-white/10 bg-black/20 backdrop-blur-xl">
-              <div className="absolute inset-0 bg-gradient-to-r from-red-500/10 via-transparent to-pink-500/10" />
+            <div className="border-fm-divider-secondary bg-fm-surface-secondary relative overflow-hidden border-b backdrop-blur-xl">
+              <div className="from-fm-icon-negative/10 to-fm-secondary-500/10 absolute inset-0 bg-linear-to-r via-transparent" />
               <div className="relative !mx-auto max-w-7xl px-6 py-16">
                 <div className="!space-y-6 text-center">
-                  <div className="!mx-auto flex h-24 w-24 items-center justify-center rounded-2xl border border-red-500/30 bg-gradient-to-br from-red-500/20 to-pink-500/20">
+                  <div className="border-fm-icon-negative/30 from-fm-icon-negative/20 to-fm-secondary-500/20 !mx-auto flex h-24 w-24 items-center justify-center rounded-2xl border bg-linear-to-br">
                     <SiteLogoIcon className="h-12 w-12" />
                   </div>
                   <h1 className="!text-fm-primary text-5xl font-bold">
                     SiteLogoIcon
                   </h1>
-                  <p className="!mx-auto max-w-3xl text-xl leading-relaxed !text-white/70">
+                  <p className="text-fm-secondary! !mx-auto max-w-3xl text-xl leading-relaxed">
                     The official Aural UI site logo icon for brand identity,
                     navigation headers, and app branding. Features a distinctive
                     red gradient design with speech bubble elements. Built with
@@ -117,28 +117,28 @@ const meta: Meta<typeof SiteLogoIcon> = {
                   {/* Stats */}
                   <div className="flex items-center justify-center gap-8 pt-8">
                     <div className="text-center">
-                      <div className="text-3xl font-bold text-red-300">
+                      <div className="text-fm-icon-negative text-3xl font-bold">
                         Brand
                       </div>
-                      <div className="text-sm text-white/60">
+                      <div className="text-fm-tertiary text-sm">
                         Identity focused
                       </div>
                     </div>
-                    <div className="h-8 w-px bg-white/20" />
+                    <div className="bg-fm-divider-primary h-8 w-px" />
                     <div className="text-center">
-                      <div className="text-3xl font-bold text-pink-300">
+                      <div className="text-fm-secondary-600 text-3xl font-bold">
                         Scalable
                       </div>
-                      <div className="text-sm text-white/60">
+                      <div className="text-fm-tertiary text-sm">
                         All sizes supported
                       </div>
                     </div>
-                    <div className="h-8 w-px bg-white/20" />
+                    <div className="bg-fm-divider-primary h-8 w-px" />
                     <div className="text-center">
-                      <div className="text-3xl font-bold text-rose-300">
+                      <div className="text-fm-icon-negative text-3xl font-bold">
                         Accessible
                       </div>
-                      <div className="text-sm text-white/60">
+                      <div className="text-fm-tertiary text-sm">
                         Screen reader ready
                       </div>
                     </div>
@@ -151,16 +151,16 @@ const meta: Meta<typeof SiteLogoIcon> = {
             <div className="!mx-auto max-w-7xl !space-y-16 px-6 py-12">
               {/* Quick Usage */}
               <div className="!space-y-8">
-                <h2 className="text-center text-3xl font-bold !text-white">
+                <h2 className="text-fm-icon-active! text-center text-3xl font-bold">
                   Quick Start
                 </h2>
                 <div className="grid grid-cols-1 gap-8 lg:grid-cols-2">
                   <div className="!space-y-4">
-                    <h3 className="text-xl font-semibold !text-red-300">
+                    <h3 className="text-fm-icon-negative! text-xl font-semibold">
                       Basic Usage
                     </h3>
-                    <div className="rounded-lg bg-black/40 p-4">
-                      <pre className="overflow-x-auto text-sm !text-green-300">
+                    <div className="bg-fm-surface-secondary rounded-lg p-4">
+                      <pre className="text-fm-icon-positive! overflow-x-auto text-sm">
                         {`import { SiteLogoIcon } from "@icons/site-logo-icon"
 
 function Header() {
@@ -176,13 +176,13 @@ function Header() {
                   </div>
 
                   <div className="!space-y-4">
-                    <h3 className="text-xl font-semibold !text-red-300">
+                    <h3 className="text-fm-icon-negative! text-xl font-semibold">
                       Live Preview
                     </h3>
-                    <div className="flex h-32 items-center justify-center rounded-lg border border-white/10 bg-white/5">
-                      <div className="flex items-center gap-3 rounded-lg border border-red-500/20 bg-red-500/10 px-6 py-3">
+                    <div className="border-fm-divider-secondary bg-fm-surface-secondary flex h-32 items-center justify-center rounded-lg border">
+                      <div className="border-fm-icon-negative/20 bg-fm-icon-negative/10 flex items-center gap-3 rounded-lg border px-6 py-3">
                         <SiteLogoIcon className="h-8 w-8" />
-                        <span className="text-xl font-bold text-white">
+                        <span className="text-fm-icon-active text-xl font-bold">
                           Aural UI
                         </span>
                       </div>
@@ -193,94 +193,102 @@ function Header() {
 
               {/* Props Documentation */}
               <div className="!space-y-8">
-                <h2 className="text-center text-3xl font-bold !text-white">
+                <h2 className="text-fm-icon-active! text-center text-3xl font-bold">
                   Props & Configuration
                 </h2>
 
-                <div className="overflow-hidden rounded-lg border border-white/10 bg-white/5">
-                  <div className="bg-white/5 p-4">
-                    <h3 className="text-xl font-semibold !text-white">Props</h3>
+                <div className="border-fm-divider-secondary bg-fm-surface-secondary overflow-hidden rounded-lg border">
+                  <div className="bg-fm-surface-secondary p-4">
+                    <h3 className="text-fm-icon-active! text-xl font-semibold">
+                      Props
+                    </h3>
                   </div>
                   <table className="!my-0 w-full">
-                    <thead className="bg-white/5">
-                      <tr className="border-b border-white/10">
-                        <th className="px-6 py-4 text-left text-sm font-semibold !text-white">
+                    <thead className="bg-fm-surface-secondary">
+                      <tr className="border-fm-divider-secondary border-b">
+                        <th className="text-fm-icon-active! px-6 py-4 text-left text-sm font-semibold">
                           Prop
                         </th>
-                        <th className="px-6 py-4 text-left text-sm font-semibold !text-white">
+                        <th className="text-fm-icon-active! px-6 py-4 text-left text-sm font-semibold">
                           Type
                         </th>
-                        <th className="px-6 py-4 text-left text-sm font-semibold !text-white">
+                        <th className="text-fm-icon-active! px-6 py-4 text-left text-sm font-semibold">
                           Default
                         </th>
-                        <th className="px-6 py-4 text-left text-sm font-semibold !text-white">
+                        <th className="text-fm-icon-active! px-6 py-4 text-left text-sm font-semibold">
                           Description
                         </th>
                       </tr>
                     </thead>
                     <tbody>
                       {" "}
-                      <tr className="!bg-black/10">
-                        <td className="px-6 py-4 font-mono text-sm !text-blue-300">
+                      <tr className="bg-fm-surface-secondary!">
+                        <td className="text-fm-icon-info! px-6 py-4 font-mono text-sm">
                           withAccessibility
                         </td>
-                        <td className="px-6 py-4 text-sm !text-white/70">
+                        <td className="text-fm-secondary! px-6 py-4 text-sm">
                           boolean
                         </td>
-                        <td className="px-6 py-4 text-sm !text-white/50">
+                        <td className="text-fm-placeholder! px-6 py-4 text-sm">
                           true
                         </td>
-                        <td className="px-6 py-4 text-sm !text-white/70">
+                        <td className="text-fm-secondary! px-6 py-4 text-sm">
                           Whether to wrap the icon with accessibility feature
                         </td>
                       </tr>
-                      <tr className="border-b border-white/5 !bg-black/10">
-                        <td className="px-6 py-4 font-mono text-sm !text-red-300">
+                      <tr className="border-fm-divider-tertiary bg-fm-surface-secondary! border-b">
+                        <td className="text-fm-icon-negative! px-6 py-4 font-mono text-sm">
                           height
                         </td>
-                        <td className="px-6 py-4 text-sm !text-white/70">
+                        <td className="text-fm-secondary! px-6 py-4 text-sm">
                           number | string
                         </td>
-                        <td className="px-6 py-4 text-sm !text-white/50">22</td>
-                        <td className="px-6 py-4 text-sm !text-white/70">
+                        <td className="text-fm-placeholder! px-6 py-4 text-sm">
+                          22
+                        </td>
+                        <td className="text-fm-secondary! px-6 py-4 text-sm">
                           Height of the logo in pixels
                         </td>
                       </tr>
-                      <tr className="border-b border-white/5">
-                        <td className="px-6 py-4 font-mono text-sm !text-red-300">
+                      <tr className="border-fm-divider-tertiary border-b">
+                        <td className="text-fm-icon-negative! px-6 py-4 font-mono text-sm">
                           className
                         </td>
-                        <td className="px-6 py-4 text-sm !text-white/70">
+                        <td className="text-fm-secondary! px-6 py-4 text-sm">
                           string
                         </td>
-                        <td className="px-6 py-4 text-sm !text-white/50">-</td>
-                        <td className="px-6 py-4 text-sm !text-white/70">
+                        <td className="text-fm-placeholder! px-6 py-4 text-sm">
+                          -
+                        </td>
+                        <td className="text-fm-secondary! px-6 py-4 text-sm">
                           CSS classes for styling
                         </td>
                       </tr>
-                      <tr className="border-b border-white/5 !bg-black/10">
-                        <td className="px-6 py-4 font-mono text-sm !text-red-300">
+                      <tr className="border-fm-divider-tertiary bg-fm-surface-secondary! border-b">
+                        <td className="text-fm-icon-negative! px-6 py-4 font-mono text-sm">
                           viewBox
                         </td>
-                        <td className="px-6 py-4 text-sm !text-white/70">
+                        <td className="text-fm-secondary! px-6 py-4 text-sm">
                           string
                         </td>
-                        <td className="px-6 py-4 text-sm !text-white/50">
+                        <td className="text-fm-placeholder! px-6 py-4 text-sm">
                           "0 0 128 128"
                         </td>
-                        <td className="px-6 py-4 text-sm !text-white/70">
+                        <td className="text-fm-secondary! px-6 py-4 text-sm">
                           SVG viewBox for scaling
                         </td>
                       </tr>
-                      <tr className="!bg-black/10">
-                        <td className="px-6 py-4 font-mono text-sm !text-red-300">
+                      <tr className="bg-fm-surface-secondary!">
+                        <td className="text-fm-icon-negative! px-6 py-4 font-mono text-sm">
                           ...svgProps
                         </td>
-                        <td className="px-6 py-4 text-sm !text-white/70">
+                        <td className="text-fm-secondary! px-6 py-4 text-sm">
                           SVGProps
                         </td>
-                        <td className="px-6 py-4 text-sm !text-white/50">-</td>
-                        <td className="px-6 py-4 text-sm !text-white/70">
+                        <td className="text-fm-placeholder! px-6 py-4 text-sm">
+                          -
+                        </td>
+                        <td className="text-fm-secondary! px-6 py-4 text-sm">
                           All standard SVG element props
                         </td>
                       </tr>
@@ -291,50 +299,62 @@ function Header() {
 
               {/* Size Variations */}
               <div className="!space-y-8">
-                <h2 className="text-center text-3xl font-bold !text-white">
+                <h2 className="text-fm-icon-active! text-center text-3xl font-bold">
                   Size Variations
                 </h2>
-                <div className="rounded-lg border border-white/10 bg-white/5 p-8">
+                <div className="border-fm-divider-secondary bg-fm-surface-secondary rounded-lg border p-8">
                   <div className="!space-y-6">
                     <div className="grid grid-cols-1 gap-8 md:grid-cols-2">
                       <div className="!space-y-4">
-                        <h3 className="text-lg font-semibold !text-red-300">
+                        <h3 className="text-fm-icon-negative! text-lg font-semibold">
                           Standard Sizes
                         </h3>
-                        <div className="flex items-end gap-6 rounded-lg bg-black/20 p-6">
+                        <div className="bg-fm-surface-secondary flex items-end gap-6 rounded-lg p-6">
                           <div className="text-center">
                             <SiteLogoIcon className="!mx-auto mb-2 h-4 w-4" />
-                            <span className="text-xs text-white/60">16px</span>
+                            <span className="text-fm-tertiary text-xs">
+                              16px
+                            </span>
                           </div>
                           <div className="text-center">
                             <SiteLogoIcon className="!mx-auto mb-2 h-5 w-5" />
-                            <span className="text-xs text-white/60">20px</span>
+                            <span className="text-fm-tertiary text-xs">
+                              20px
+                            </span>
                           </div>
                           <div className="text-center">
                             <SiteLogoIcon className="!mx-auto mb-2 h-6 w-6" />
-                            <span className="text-xs text-white/60">24px</span>
+                            <span className="text-fm-tertiary text-xs">
+                              24px
+                            </span>
                           </div>
                           <div className="text-center">
                             <SiteLogoIcon className="!mx-auto mb-2 h-8 w-8" />
-                            <span className="text-xs text-white/60">32px</span>
+                            <span className="text-fm-tertiary text-xs">
+                              32px
+                            </span>
                           </div>
                           <div className="text-center">
                             <SiteLogoIcon className="!mx-auto mb-2 h-12 w-12" />
-                            <span className="text-xs text-white/60">48px</span>
+                            <span className="text-fm-tertiary text-xs">
+                              48px
+                            </span>
                           </div>
                           <div className="text-center">
                             <SiteLogoIcon className="!mx-auto mb-2 h-16 w-16" />
-                            <span className="text-xs text-white/60">64px</span>
+                            <span className="text-fm-tertiary text-xs">
+                              64px
+                            </span>
                           </div>
                         </div>
                       </div>
 
                       <div className="!space-y-4">
-                        <h3 className="text-lg font-semibold !text-red-300">
+                        <h3 className="text-fm-icon-negative! text-lg font-semibold">
                           Code Example
                         </h3>
-                        <div className="rounded-lg bg-black/40 p-4">
-                          <pre className="overflow-x-auto text-sm !text-blue-300">
+                        <div className="bg-fm-surface-secondary rounded-lg p-4">
+                          <pre className="text-fm-icon-info! overflow-x-auto text-sm">
                             {`// Small nav (24px)
 <SiteLogoIcon className="h-6 w-6" />
 
@@ -359,49 +379,49 @@ function Header() {
 
               {/* Usage Examples */}
               <div className="!space-y-8">
-                <h2 className="text-center text-3xl font-bold !text-white">
+                <h2 className="text-fm-icon-active! text-center text-3xl font-bold">
                   Usage Examples
                 </h2>
 
                 <div className="grid grid-cols-1 gap-8 lg:grid-cols-2">
                   {/* Navigation Header */}
                   <div className="!space-y-4">
-                    <h3 className="text-lg font-semibold !text-red-300">
+                    <h3 className="text-fm-icon-negative! text-lg font-semibold">
                       Navigation Header
                     </h3>
                     <div className="!space-y-4">
-                      <div className="rounded-lg border border-white/10 bg-white/5 p-4">
+                      <div className="border-fm-divider-secondary bg-fm-surface-secondary rounded-lg border p-4">
                         <div className="flex items-center justify-between">
                           <div className="flex items-center gap-3">
                             <SiteLogoIcon className="h-8 w-8" />
-                            <span className="text-xl font-bold text-white">
+                            <span className="text-fm-icon-active text-xl font-bold">
                               Aural UI
                             </span>
                           </div>
                           <nav className="flex items-center gap-6">
                             <a
                               href="#"
-                              className="text-white/70 hover:text-white"
+                              className="text-fm-secondary hover:text-fm-icon-active"
                             >
                               Docs
                             </a>
                             <a
                               href="#"
-                              className="text-white/70 hover:text-white"
+                              className="text-fm-secondary hover:text-fm-icon-active"
                             >
                               Components
                             </a>
                             <a
                               href="#"
-                              className="text-white/70 hover:text-white"
+                              className="text-fm-secondary hover:text-fm-icon-active"
                             >
                               Examples
                             </a>
                           </nav>
                         </div>
                       </div>
-                      <div className="rounded-lg bg-black/40 p-4">
-                        <pre className="overflow-x-auto text-sm !text-green-300">
+                      <div className="bg-fm-surface-secondary rounded-lg p-4">
+                        <pre className="text-fm-icon-positive! overflow-x-auto text-sm">
                           {`<div className="flex items-center justify-between">
   <div className="flex items-center gap-3">
     <SiteLogoIcon className="h-8 w-8" />
@@ -420,44 +440,44 @@ function Header() {
 
                   {/* Footer Branding */}
                   <div className="!space-y-4">
-                    <h3 className="text-lg font-semibold !text-red-300">
+                    <h3 className="text-fm-icon-negative! text-lg font-semibold">
                       Footer Branding
                     </h3>
                     <div className="!space-y-4">
-                      <div className="rounded-lg border border-white/10 bg-white/5 p-6">
+                      <div className="border-fm-divider-secondary bg-fm-surface-secondary rounded-lg border p-6">
                         <div className="!space-y-4 text-center">
                           <SiteLogoIcon className="!mx-auto h-12 w-12" />
-                          <h3 className="text-lg font-bold !text-white">
+                          <h3 className="text-fm-icon-active! text-lg font-bold">
                             Aural UI
                           </h3>
-                          <p className="text-sm !text-white/60">
+                          <p className="text-fm-tertiary! text-sm">
                             Beautiful, accessible components for modern web
                             applications.
                           </p>
                           <div className="flex justify-center gap-4 pt-4">
                             <a
                               href="#"
-                              className="text-white/60 hover:text-white"
+                              className="text-fm-tertiary hover:text-fm-icon-active"
                             >
                               GitHub
                             </a>
                             <a
                               href="#"
-                              className="text-white/60 hover:text-white"
+                              className="text-fm-tertiary hover:text-fm-icon-active"
                             >
                               Documentation
                             </a>
                             <a
                               href="#"
-                              className="text-white/60 hover:text-white"
+                              className="text-fm-tertiary hover:text-fm-icon-active"
                             >
                               Support
                             </a>
                           </div>
                         </div>
                       </div>
-                      <div className="rounded-lg bg-black/40 p-4">
-                        <pre className="overflow-x-auto text-sm !text-green-300">
+                      <div className="bg-fm-surface-secondary rounded-lg p-4">
+                        <pre className="text-fm-icon-positive! overflow-x-auto text-sm">
                           {`<div className="space-y-4 text-center">
   <SiteLogoIcon className="mx-auto h-12 w-12" />
   <h3 className="text-lg font-bold">Aural UI</h3>
@@ -477,20 +497,20 @@ function Header() {
 
                   {/* Loading/Splash Screen */}
                   <div className="!space-y-4">
-                    <h3 className="text-lg font-semibold !text-red-300">
+                    <h3 className="text-fm-icon-negative! text-lg font-semibold">
                       Loading & Splash Screen
                     </h3>
                     <div className="!space-y-4">
-                      <div className="flex items-center justify-center rounded-lg border border-white/10 bg-gradient-to-br from-red-500/10 to-pink-500/10 p-6">
+                      <div className="border-fm-divider-secondary from-fm-icon-negative/10 to-fm-secondary-500/10 flex items-center justify-center rounded-lg border bg-linear-to-br p-6">
                         <div className="text-center">
                           <SiteLogoIcon className="animate-logo-pulse !mx-auto h-16 w-16" />
-                          <p className="mt-4 text-sm !text-white/70">
+                          <p className="text-fm-secondary! mt-4 text-sm">
                             Loading...
                           </p>
                         </div>
                       </div>
-                      <div className="rounded-lg bg-black/40 p-4">
-                        <pre className="overflow-x-auto text-sm !text-green-300">
+                      <div className="bg-fm-surface-secondary rounded-lg p-4">
+                        <pre className="text-fm-icon-positive! overflow-x-auto text-sm">
                           {`// Loading with pulse animation
 <div className="text-center">
   <SiteLogoIcon className="mx-auto h-16 w-16 animate-pulse" />
@@ -511,42 +531,46 @@ function Header() {
 
                   {/* App Icon/Favicon */}
                   <div className="!space-y-4">
-                    <h3 className="text-lg font-semibold !text-red-300">
+                    <h3 className="text-fm-icon-negative! text-lg font-semibold">
                       App Icon Usage
                     </h3>
                     <div className="!space-y-4">
                       <div className="grid grid-cols-4 gap-4">
                         <div className="flex flex-col items-center justify-center !space-y-2 text-center">
-                          <div className="flex h-12 w-12 items-center justify-center rounded-lg bg-white p-2 shadow-lg">
+                          <div className="bg-fm-surface-contrast flex h-12 w-12 items-center justify-center rounded-lg p-2 shadow-lg">
                             <SiteLogoIcon className="h-8 w-8" />
                           </div>
-                          <span className="text-xs text-white/60">
+                          <span className="text-fm-tertiary text-xs">
                             App Icon
                           </span>
                         </div>
                         <div className="flex flex-col items-center justify-center !space-y-2 text-center">
-                          <div className="flex h-12 w-12 items-center justify-center rounded-full bg-white p-2 shadow-lg">
+                          <div className="bg-fm-surface-contrast flex h-12 w-12 items-center justify-center rounded-full p-2 shadow-lg">
                             <SiteLogoIcon className="h-8 w-8" />
                           </div>
-                          <span className="text-xs text-white/60">Round</span>
+                          <span className="text-fm-tertiary text-xs">
+                            Round
+                          </span>
                         </div>
                         <div className="flex flex-col items-center justify-center !space-y-2 text-center">
-                          <div className="flex h-12 w-12 items-center justify-center rounded bg-gradient-to-br from-red-500 to-pink-500 p-2 shadow-lg">
+                          <div className="from-fm-icon-negative to-fm-secondary-500 flex h-12 w-12 items-center justify-center rounded bg-linear-to-br p-2 shadow-lg">
                             <SiteLogoIcon className="h-8 w-8" />
                           </div>
-                          <span className="text-xs text-white/60">Branded</span>
+                          <span className="text-fm-tertiary text-xs">
+                            Branded
+                          </span>
                         </div>
                         <div className="flex flex-col items-center justify-center !space-y-2 text-center">
-                          <div className="flex h-12 w-12 items-center justify-center rounded-xl border border-red-500/20 bg-red-500/10 p-2">
+                          <div className="border-fm-icon-negative/20 bg-fm-icon-negative/10 flex h-12 w-12 items-center justify-center rounded-xl border p-2">
                             <SiteLogoIcon className="h-8 w-8" />
                           </div>
-                          <span className="text-xs text-white/60">
+                          <span className="text-fm-tertiary text-xs">
                             Outlined
                           </span>
                         </div>
                       </div>
-                      <div className="rounded-lg bg-black/40 p-4">
-                        <pre className="overflow-x-auto text-sm !text-green-300">
+                      <div className="bg-fm-surface-secondary rounded-lg p-4">
+                        <pre className="text-fm-icon-positive! overflow-x-auto text-sm">
                           {`// Standard app icon
 <div className="flex h-12 w-12 items-center justify-center rounded-lg bg-white p-2">
   <SiteLogoIcon className="h-8 w-8" />
@@ -569,22 +593,22 @@ function Header() {
 
               {/* Interactive States */}
               <div className="!space-y-8">
-                <h2 className="text-center text-3xl font-bold !text-white">
+                <h2 className="text-fm-icon-active! text-center text-3xl font-bold">
                   Interactive States & Animations
                 </h2>
                 <div className="grid grid-cols-1 gap-8 lg:grid-cols-2">
                   <div className="!space-y-4">
-                    <h3 className="text-lg font-semibold !text-red-300">
+                    <h3 className="text-fm-icon-negative! text-lg font-semibold">
                       Animation Effects
                     </h3>
-                    <div className="!space-y-4 rounded-lg border border-white/10 bg-white/5 p-6">
+                    <div className="border-fm-divider-secondary bg-fm-surface-secondary !space-y-4 rounded-lg border p-6">
                       <div className="flex items-center gap-4">
                         <SiteLogoIcon className="h-8 w-8 transition-transform hover:scale-110" />
                         <div>
-                          <div className="text-sm font-medium text-white">
+                          <div className="text-fm-icon-active text-sm font-medium">
                             Scale on Hover
                           </div>
-                          <div className="text-xs text-white/60">
+                          <div className="text-fm-tertiary text-xs">
                             Subtle growth effect
                           </div>
                         </div>
@@ -592,10 +616,10 @@ function Header() {
                       <div className="flex items-center gap-4">
                         <SiteLogoIcon className="animate-logo-pulse h-8 w-8" />
                         <div>
-                          <div className="text-sm font-medium text-white">
+                          <div className="text-fm-icon-active text-sm font-medium">
                             Pulse Animation
                           </div>
-                          <div className="text-xs text-white/60">
+                          <div className="text-fm-tertiary text-xs">
                             Breathing effect
                           </div>
                         </div>
@@ -603,10 +627,10 @@ function Header() {
                       <div className="flex items-center gap-4">
                         <SiteLogoIcon className="animate-logo-glow h-8 w-8" />
                         <div>
-                          <div className="text-sm font-medium text-white">
+                          <div className="text-fm-icon-active text-sm font-medium">
                             Glow Effect
                           </div>
-                          <div className="text-xs text-white/60">
+                          <div className="text-fm-tertiary text-xs">
                             Brand color glow
                           </div>
                         </div>
@@ -614,10 +638,10 @@ function Header() {
                       <div className="flex items-center gap-4">
                         <SiteLogoIcon className="h-8 w-8 transition-opacity hover:opacity-80" />
                         <div>
-                          <div className="text-sm font-medium text-white">
+                          <div className="text-fm-icon-active text-sm font-medium">
                             Opacity Change
                           </div>
-                          <div className="text-xs text-white/60">
+                          <div className="text-fm-tertiary text-xs">
                             Fade on interaction
                           </div>
                         </div>
@@ -626,11 +650,11 @@ function Header() {
                   </div>
 
                   <div className="!space-y-4">
-                    <h3 className="text-lg font-semibold !text-red-300">
+                    <h3 className="text-fm-icon-negative! text-lg font-semibold">
                       Interactive Examples
                     </h3>
-                    <div className="rounded-lg bg-black/40 p-4">
-                      <pre className="overflow-x-auto text-sm !text-cyan-300">
+                    <div className="bg-fm-surface-secondary rounded-lg p-4">
+                      <pre className="text-fm-icon-info! overflow-x-auto text-sm">
                         {`// Hover scale effect
 <SiteLogoIcon className="h-8 w-8 transition-transform hover:scale-110" />
 
@@ -662,91 +686,91 @@ function Header() {
 
               {/* Brand Guidelines */}
               <div className="!space-y-8">
-                <h2 className="text-center text-3xl font-bold !text-white">
+                <h2 className="text-fm-icon-active! text-center text-3xl font-bold">
                   Brand Guidelines
                 </h2>
                 <div className="grid grid-cols-1 gap-8 md:grid-cols-2">
-                  <div className="!space-y-4 rounded-lg border border-white/10 bg-white/5 p-6">
-                    <h3 className="text-lg font-semibold !text-green-300">
+                  <div className="border-fm-divider-secondary bg-fm-surface-secondary !space-y-4 rounded-lg border p-6">
+                    <h3 className="text-fm-icon-positive! text-lg font-semibold">
                       ✅ Do's
                     </h3>
-                    <ul className="!space-y-2 text-sm !text-white/70">
-                      <li className="!text-white/70">
+                    <ul className="text-fm-secondary! !space-y-2 text-sm">
+                      <li className="text-fm-secondary!">
                         Use the logo at readable sizes (minimum 16px)
                       </li>
-                      <li className="!text-white/70">
+                      <li className="text-fm-secondary!">
                         Maintain the original aspect ratio
                       </li>
-                      <li className="!text-white/70">
+                      <li className="text-fm-secondary!">
                         Use on contrasting backgrounds for visibility
                       </li>
-                      <li className="!text-white/70">
+                      <li className="text-fm-secondary!">
                         Pair with consistent brand typography
                       </li>
-                      <li className="!text-white/70">
+                      <li className="text-fm-secondary!">
                         Use as a clickable element for navigation
                       </li>
                     </ul>
                   </div>
 
-                  <div className="!space-y-4 rounded-lg border border-white/10 bg-white/5 p-6">
-                    <h3 className="text-lg font-semibold !text-red-300">
+                  <div className="border-fm-divider-secondary bg-fm-surface-secondary !space-y-4 rounded-lg border p-6">
+                    <h3 className="text-fm-icon-negative! text-lg font-semibold">
                       ❌ Don'ts
                     </h3>
-                    <ul className="!space-y-2 text-sm !text-white/70">
-                      <li className="!text-white/70">
+                    <ul className="text-fm-secondary! !space-y-2 text-sm">
+                      <li className="text-fm-secondary!">
                         Don't modify the logo colors or design
                       </li>
-                      <li className="!text-white/70">
+                      <li className="text-fm-secondary!">
                         Don't stretch or skew the proportions
                       </li>
-                      <li className="!text-white/70">
+                      <li className="text-fm-secondary!">
                         Don't use on busy or conflicting backgrounds
                       </li>
-                      <li className="!text-white/70">
+                      <li className="text-fm-secondary!">
                         Don't use below 16px for accessibility
                       </li>
-                      <li className="!text-white/70">
+                      <li className="text-fm-secondary!">
                         Don't rotate or flip the logo
                       </li>
                     </ul>
                   </div>
                 </div>
 
-                <div className="rounded-lg border border-white/10 bg-white/5 p-6">
-                  <h3 className="mb-4 text-lg font-semibold !text-purple-300">
+                <div className="border-fm-divider-secondary bg-fm-surface-secondary rounded-lg border p-6">
+                  <h3 className="text-fm-secondary-600! mb-4 text-lg font-semibold">
                     Background & Contrast Guidelines
                   </h3>
                   <div className="grid grid-cols-2 gap-6 lg:grid-cols-4">
                     <div className="flex flex-col items-center justify-center !space-y-2 text-center">
-                      <div className="flex h-16 w-16 items-center justify-center rounded-lg bg-white">
+                      <div className="bg-fm-surface-contrast flex h-16 w-16 items-center justify-center rounded-lg">
                         <SiteLogoIcon className="h-10 w-10" />
                       </div>
-                      <span className="text-xs text-green-400">
+                      <span className="text-fm-icon-positive text-xs">
                         ✅ Light backgrounds
                       </span>
                     </div>
                     <div className="flex flex-col items-center justify-center !space-y-2 text-center">
-                      <div className="flex h-16 w-16 items-center justify-center rounded-lg bg-gray-100">
+                      <div className="bg-fm-surface-secondary flex h-16 w-16 items-center justify-center rounded-lg">
                         <SiteLogoIcon className="h-10 w-10" />
                       </div>
-                      <span className="text-xs text-green-400">
+                      <span className="text-fm-icon-positive text-xs">
                         ✅ Neutral tones
                       </span>
                     </div>
                     <div className="flex flex-col items-center justify-center !space-y-2 text-center">
-                      <div className="flex h-16 w-16 items-center justify-center rounded-lg bg-blue-900">
+                      <div className="bg-fm-icon-info-sec flex h-16 w-16 items-center justify-center rounded-lg">
                         <SiteLogoIcon className="h-10 w-10" />
                       </div>
-                      <span className="text-xs text-green-400">
+                      <span className="text-fm-icon-positive text-xs">
                         ✅ Dark colors
                       </span>
                     </div>
                     <div className="flex flex-col items-center justify-center !space-y-2 text-center">
-                      <div className="flex h-16 w-16 items-center justify-center rounded-lg bg-gradient-to-br from-red-400 to-red-600">
+                      <div className="from-fm-icon-negative to-fm-icon-negative flex h-16 w-16 items-center justify-center rounded-lg bg-linear-to-br">
                         <SiteLogoIcon className="h-10 w-10" />
                       </div>
-                      <span className="text-xs text-red-400">
+                      <span className="text-fm-icon-negative text-xs">
                         ❌ Similar reds
                       </span>
                     </div>
@@ -756,64 +780,64 @@ function Header() {
 
               {/* Accessibility */}
               <div className="!space-y-8">
-                <h2 className="text-center text-3xl font-bold !text-white">
+                <h2 className="text-fm-icon-active! text-center text-3xl font-bold">
                   Accessibility Features
                 </h2>
                 <div className="grid grid-cols-1 gap-8 md:grid-cols-2">
-                  <div className="!space-y-4 rounded-lg border border-white/10 bg-white/5 p-6">
-                    <h3 className="text-lg font-semibold !text-green-300">
+                  <div className="border-fm-divider-secondary bg-fm-surface-secondary !space-y-4 rounded-lg border p-6">
+                    <h3 className="text-fm-icon-positive! text-lg font-semibold">
                       ✅ Built-in Features
                     </h3>
-                    <ul className="!space-y-2 text-sm !text-white/70">
-                      <li className="!text-white/70">
+                    <ul className="text-fm-secondary! !space-y-2 text-sm">
+                      <li className="text-fm-secondary!">
                         Uses Radix UI AccessibleIcon wrapper
                       </li>
-                      <li className="!text-white/70">
+                      <li className="text-fm-secondary!">
                         Provides screen reader label "Site Logo icon"
                       </li>
-                      <li className="!text-white/70">
+                      <li className="text-fm-secondary!">
                         Supports keyboard navigation when clickable
                       </li>
-                      <li className="!text-white/70">
+                      <li className="text-fm-secondary!">
                         Scalable vector format for all screen sizes
                       </li>
-                      <li className="!text-white/70">
+                      <li className="text-fm-secondary!">
                         High contrast brand colors for visibility
                       </li>
                     </ul>
                   </div>
 
-                  <div className="!space-y-4 rounded-lg border border-white/10 bg-white/5 p-6">
-                    <h3 className="text-lg font-semibold !text-red-300">
+                  <div className="border-fm-divider-secondary bg-fm-surface-secondary !space-y-4 rounded-lg border p-6">
+                    <h3 className="text-fm-icon-negative! text-lg font-semibold">
                       💡 Best Practices
                     </h3>
-                    <ul className="!space-y-2 text-sm !text-white/70">
-                      <li className="!text-white/70">
+                    <ul className="text-fm-secondary! !space-y-2 text-sm">
+                      <li className="text-fm-secondary!">
                         Always include alt text when used as content
                       </li>
-                      <li className="!text-white/70">
+                      <li className="text-fm-secondary!">
                         Use as clickable link to homepage
                       </li>
-                      <li className="!text-white/70">
+                      <li className="text-fm-secondary!">
                         Ensure sufficient size for touch targets
                       </li>
-                      <li className="!text-white/70">
+                      <li className="text-fm-secondary!">
                         Add focus indicators for keyboard navigation
                       </li>
-                      <li className="!text-white/70">
+                      <li className="text-fm-secondary!">
                         Test with screen readers and voice control
                       </li>
                     </ul>
                   </div>
                 </div>
 
-                <div className="rounded-lg border border-white/10 bg-white/5 p-6">
-                  <h3 className="mb-4 text-lg font-semibold !text-purple-300">
+                <div className="border-fm-divider-secondary bg-fm-surface-secondary rounded-lg border p-6">
+                  <h3 className="text-fm-secondary-600! mb-4 text-lg font-semibold">
                     Accessibility Implementation
                   </h3>
                   <div className="grid grid-cols-1 gap-6 lg:grid-cols-2">
-                    <div className="rounded-lg bg-black/40 p-4">
-                      <pre className="overflow-x-auto text-sm !text-cyan-300">
+                    <div className="bg-fm-surface-secondary rounded-lg p-4">
+                      <pre className="text-fm-icon-info! overflow-x-auto text-sm">
                         {`// Logo as homepage link
 <a 
   href="/" 
@@ -842,14 +866,14 @@ import { AccessibleIcon } from "@radix-ui/react-accessible-icon"
                       </pre>
                     </div>
                     <div className="!space-y-4">
-                      <p className="text-sm !text-white/70">
+                      <p className="text-fm-secondary! text-sm">
                         When using the SiteLogoIcon as navigation, always
                         provide clear context about its purpose and destination.
                         The built-in accessible label helps screen readers
                         identify the element.
                       </p>
-                      <div className="rounded-lg border border-red-500/20 bg-red-500/10 p-4">
-                        <div className="flex items-center gap-2 text-sm text-red-200">
+                      <div className="border-fm-icon-negative/20 bg-fm-icon-negative/10 rounded-lg border p-4">
+                        <div className="text-fm-icon-negative flex items-center gap-2 text-sm">
                           <SiteLogoIcon className="h-4 w-4" />
                           <span>
                             This ensures all users can navigate effectively
@@ -863,44 +887,54 @@ import { AccessibleIcon } from "@radix-ui/react-accessible-icon"
 
               {/* Related Components */}
               <div className="!space-y-8">
-                <h2 className="text-center text-3xl font-bold !text-white">
+                <h2 className="text-fm-icon-active! text-center text-3xl font-bold">
                   Related Components
                 </h2>
                 <div className="grid grid-cols-2 gap-6 md:grid-cols-4">
-                  <div className="!space-y-3 rounded-lg border border-white/10 bg-white/5 p-4 text-center">
-                    <div className="!mx-auto flex h-12 w-12 items-center justify-center rounded-lg bg-blue-500/20">
+                  <div className="border-fm-divider-secondary bg-fm-surface-secondary !space-y-3 rounded-lg border p-4 text-center">
+                    <div className="bg-fm-icon-info/20 !mx-auto flex h-12 w-12 items-center justify-center rounded-lg">
                       <span className="text-2xl">🏠</span>
                     </div>
                     <div>
-                      <div className="font-medium text-white">HomeIcon</div>
-                      <div className="text-xs text-white/60">Navigation</div>
+                      <div className="text-fm-icon-active font-medium">
+                        HomeIcon
+                      </div>
+                      <div className="text-fm-tertiary text-xs">Navigation</div>
                     </div>
                   </div>
-                  <div className="!space-y-3 rounded-lg border border-white/10 bg-white/5 p-4 text-center">
-                    <div className="!mx-auto flex h-12 w-12 items-center justify-center rounded-lg bg-purple-500/20">
-                      <span className="!text-2xl !text-white">☰</span>
+                  <div className="border-fm-divider-secondary bg-fm-surface-secondary !space-y-3 rounded-lg border p-4 text-center">
+                    <div className="bg-fm-secondary-500/20 !mx-auto flex h-12 w-12 items-center justify-center rounded-lg">
+                      <span className="text-fm-icon-active! !text-2xl">☰</span>
                     </div>
                     <div>
-                      <div className="font-medium text-white">MenuIcon</div>
-                      <div className="text-xs text-white/60">Mobile nav</div>
+                      <div className="text-fm-icon-active font-medium">
+                        MenuIcon
+                      </div>
+                      <div className="text-fm-tertiary text-xs">Mobile nav</div>
                     </div>
                   </div>
-                  <div className="!space-y-3 rounded-lg border border-white/10 bg-white/5 p-4 text-center">
-                    <div className="!mx-auto flex h-12 w-12 items-center justify-center rounded-lg bg-green-500/20">
+                  <div className="border-fm-divider-secondary bg-fm-surface-secondary !space-y-3 rounded-lg border p-4 text-center">
+                    <div className="bg-fm-icon-positive/20 !mx-auto flex h-12 w-12 items-center justify-center rounded-lg">
                       <span className="text-2xl">⚙️</span>
                     </div>
                     <div>
-                      <div className="font-medium text-white">SettingsIcon</div>
-                      <div className="text-xs text-white/60">Configuration</div>
+                      <div className="text-fm-icon-active font-medium">
+                        SettingsIcon
+                      </div>
+                      <div className="text-fm-tertiary text-xs">
+                        Configuration
+                      </div>
                     </div>
                   </div>
-                  <div className="!space-y-3 rounded-lg border border-white/10 bg-white/5 p-4 text-center">
-                    <div className="!mx-auto flex h-12 w-12 items-center justify-center rounded-lg bg-orange-500/20">
+                  <div className="border-fm-divider-secondary bg-fm-surface-secondary !space-y-3 rounded-lg border p-4 text-center">
+                    <div className="bg-fm-icon-warning/20 !mx-auto flex h-12 w-12 items-center justify-center rounded-lg">
                       <span className="text-2xl">👤</span>
                     </div>
                     <div>
-                      <div className="font-medium text-white">UserIcon</div>
-                      <div className="text-xs text-white/60">Profile</div>
+                      <div className="text-fm-icon-active font-medium">
+                        UserIcon
+                      </div>
+                      <div className="text-fm-tertiary text-xs">Profile</div>
                     </div>
                   </div>
                 </div>
@@ -908,21 +942,21 @@ import { AccessibleIcon } from "@radix-ui/react-accessible-icon"
             </div>
 
             {/* Footer */}
-            <div className="border-t border-white/10 bg-black/20 backdrop-blur-xl">
+            <div className="border-fm-divider-secondary bg-fm-surface-secondary border-t backdrop-blur-xl">
               <div className="!mx-auto max-w-7xl px-6 py-8">
                 <div className="!space-y-4 text-center">
                   <div className="flex items-center justify-center gap-3">
                     <SiteLogoIcon className="h-8 w-8" />
-                    <span className="text-xl font-bold text-white">
+                    <span className="text-fm-icon-active text-xl font-bold">
                       Aural UI
                     </span>
                   </div>
-                  <p className="!text-white/60">
+                  <p className="text-fm-tertiary!">
                     The official SiteLogoIcon represents the Aural UI brand and
                     should be used consistently across all applications and
                     documentation.
                   </p>
-                  <p className="text-sm !text-white/40">
+                  <p className="text-fm-placeholder! text-sm">
                     Built with accessibility and brand consistency in mind. Uses
                     Radix UI's AccessibleIcon for screen reader compatibility.
                   </p>
@@ -963,8 +997,8 @@ const storyParameters = {
   backgrounds: {
     default: "dark",
     values: [
-      { name: "dark", value: "#0a0a0a" },
-      { name: "darker", value: "#000000" },
+      { name: "dark", value: "var(--color-fm-surface-primary)" },
+      { name: "darker", value: "var(--color-fm-neutral-0)" },
     ],
   },
 }
@@ -976,7 +1010,7 @@ export const Default: Story = {
   },
   parameters: storyParameters,
   render: (args) => (
-    <div className="flex h-32 min-h-dvh items-center justify-center rounded-lg bg-gradient-to-br from-gray-900 to-gray-800">
+    <div className="from-fm-surface-primary to-fm-surface-secondary flex h-32 min-h-dvh items-center justify-center rounded-lg bg-linear-to-br">
       <SiteLogoIcon {...args} />
     </div>
   ),
@@ -993,30 +1027,30 @@ export const SizeVariations: Story = {
     },
   },
   render: () => (
-    <div className="flex h-64 min-h-dvh items-center justify-center gap-8 rounded-lg bg-gradient-to-br from-gray-900 to-gray-800 p-8">
+    <div className="from-fm-surface-primary to-fm-surface-secondary flex h-64 min-h-dvh items-center justify-center gap-8 rounded-lg bg-linear-to-br p-8">
       <div className="text-center">
         <SiteLogoIcon className="!mx-auto mb-2 h-4 w-4" />
-        <span className="text-xs text-white/60">16px</span>
+        <span className="text-fm-tertiary text-xs">16px</span>
       </div>
       <div className="text-center">
         <SiteLogoIcon className="!mx-auto mb-2 h-6 w-6" />
-        <span className="text-xs text-white/60">24px</span>
+        <span className="text-fm-tertiary text-xs">24px</span>
       </div>
       <div className="text-center">
         <SiteLogoIcon className="!mx-auto mb-2 h-8 w-8" />
-        <span className="text-xs text-white/60">32px</span>
+        <span className="text-fm-tertiary text-xs">32px</span>
       </div>
       <div className="text-center">
         <SiteLogoIcon className="!mx-auto mb-2 h-12 w-12" />
-        <span className="text-xs text-white/60">48px</span>
+        <span className="text-fm-tertiary text-xs">48px</span>
       </div>
       <div className="text-center">
         <SiteLogoIcon className="!mx-auto mb-2 h-16 w-16" />
-        <span className="text-xs text-white/60">64px</span>
+        <span className="text-fm-tertiary text-xs">64px</span>
       </div>
       <div className="text-center">
         <SiteLogoIcon className="!mx-auto mb-2 h-24 w-24" />
-        <span className="text-xs text-white/60">96px</span>
+        <span className="text-fm-tertiary text-xs">96px</span>
       </div>
     </div>
   ),
@@ -1032,24 +1066,37 @@ export const NavigationUsage: Story = {
     },
   },
   render: () => (
-    <div className="min-h-dvh !space-y-8 rounded-lg bg-gradient-to-br from-gray-900 to-gray-800 p-8">
+    <div className="from-fm-surface-primary to-fm-surface-secondary min-h-dvh !space-y-8 rounded-lg bg-linear-to-br p-8">
       {/* Main Navigation */}
       <div className="!space-y-2">
-        <h3 className="text-sm font-medium text-white">Main Navigation</h3>
-        <div className="rounded-lg border border-white/10 bg-white/5 p-4">
+        <h3 className="text-fm-icon-active text-sm font-medium">
+          Main Navigation
+        </h3>
+        <div className="border-fm-divider-secondary bg-fm-surface-secondary rounded-lg border p-4">
           <div className="flex items-center justify-between">
             <div className="flex items-center gap-3">
               <SiteLogoIcon className="h-8 w-8" />
-              <span className="text-xl font-bold text-white">Aural UI</span>
+              <span className="text-fm-icon-active text-xl font-bold">
+                Aural UI
+              </span>
             </div>
             <nav className="flex items-center gap-6">
-              <a href="#" className="text-white/70 hover:text-white">
+              <a
+                href="#"
+                className="text-fm-secondary hover:text-fm-icon-active"
+              >
                 Docs
               </a>
-              <a href="#" className="text-white/70 hover:text-white">
+              <a
+                href="#"
+                className="text-fm-secondary hover:text-fm-icon-active"
+              >
                 Components
               </a>
-              <a href="#" className="text-white/70 hover:text-white">
+              <a
+                href="#"
+                className="text-fm-secondary hover:text-fm-icon-active"
+              >
                 Examples
               </a>
             </nav>
@@ -1059,25 +1106,33 @@ export const NavigationUsage: Story = {
 
       {/* Mobile Header */}
       <div className="!space-y-2">
-        <h3 className="text-sm font-medium text-white">Mobile Header</h3>
-        <div className="rounded-lg border border-white/10 bg-white/5 p-4">
+        <h3 className="text-fm-icon-active text-sm font-medium">
+          Mobile Header
+        </h3>
+        <div className="border-fm-divider-secondary bg-fm-surface-secondary rounded-lg border p-4">
           <div className="flex items-center justify-between">
             <div className="flex items-center gap-2">
               <SiteLogoIcon className="h-6 w-6" />
-              <span className="text-lg font-bold text-white">Aural UI</span>
+              <span className="text-fm-icon-active text-lg font-bold">
+                Aural UI
+              </span>
             </div>
-            <button className="text-white">☰</button>
+            <button className="text-fm-icon-active">☰</button>
           </div>
         </div>
       </div>
 
       {/* Footer */}
       <div className="!space-y-2">
-        <h3 className="text-sm font-medium text-white">Footer Branding</h3>
-        <div className="rounded-lg border border-white/10 bg-white/5 p-6 text-center">
+        <h3 className="text-fm-icon-active text-sm font-medium">
+          Footer Branding
+        </h3>
+        <div className="border-fm-divider-secondary bg-fm-surface-secondary rounded-lg border p-6 text-center">
           <SiteLogoIcon className="!mx-auto h-12 w-12" />
-          <h3 className="mt-4 text-lg font-bold text-white">Aural UI</h3>
-          <p className="mt-2 text-sm text-white/60">
+          <h3 className="text-fm-icon-active mt-4 text-lg font-bold">
+            Aural UI
+          </h3>
+          <p className="text-fm-tertiary mt-2 text-sm">
             Beautiful, accessible components for modern web applications.
           </p>
         </div>
@@ -1096,53 +1151,57 @@ export const BrandApplications: Story = {
     },
   },
   render: () => (
-    <div className="min-h-dvh !space-y-8 rounded-lg bg-gradient-to-br from-gray-900 to-gray-800 p-8">
+    <div className="from-fm-surface-primary to-fm-surface-secondary min-h-dvh !space-y-8 rounded-lg bg-linear-to-br p-8">
       {/* App Icons */}
       <div className="!space-y-4">
-        <h3 className="text-sm font-medium text-white">App Icon Variations</h3>
+        <h3 className="text-fm-icon-active text-sm font-medium">
+          App Icon Variations
+        </h3>
         <div className="grid grid-cols-4 gap-4">
           <div className="!space-y-2 text-center">
-            <div className="flex h-16 w-16 items-center justify-center rounded-lg bg-white shadow-lg">
+            <div className="bg-fm-surface-contrast flex h-16 w-16 items-center justify-center rounded-lg shadow-lg">
               <SiteLogoIcon className="h-12 w-12" />
             </div>
-            <span className="text-xs text-white/60">Standard</span>
+            <span className="text-fm-tertiary text-xs">Standard</span>
           </div>
           <div className="!space-y-2 text-center">
-            <div className="flex h-16 w-16 items-center justify-center rounded-full bg-white shadow-lg">
+            <div className="bg-fm-surface-contrast flex h-16 w-16 items-center justify-center rounded-full shadow-lg">
               <SiteLogoIcon className="h-12 w-12" />
             </div>
-            <span className="text-xs text-white/60">Round</span>
+            <span className="text-fm-tertiary text-xs">Round</span>
           </div>
           <div className="!space-y-2 text-center">
-            <div className="flex h-16 w-16 items-center justify-center rounded-xl bg-gradient-to-br from-red-500 to-pink-500 shadow-lg">
+            <div className="from-fm-icon-negative to-fm-secondary-500 flex h-16 w-16 items-center justify-center rounded-xl bg-linear-to-br shadow-lg">
               <SiteLogoIcon className="h-12 w-12" />
             </div>
-            <span className="text-xs text-white/60">Branded</span>
+            <span className="text-fm-tertiary text-xs">Branded</span>
           </div>
           <div className="!space-y-2 text-center">
-            <div className="flex h-16 w-16 items-center justify-center rounded-xl border-2 border-red-500/20 bg-red-500/10">
+            <div className="border-fm-icon-negative/20 bg-fm-icon-negative/10 flex h-16 w-16 items-center justify-center rounded-xl border-2">
               <SiteLogoIcon className="h-12 w-12" />
             </div>
-            <span className="text-xs text-white/60">Outlined</span>
+            <span className="text-fm-tertiary text-xs">Outlined</span>
           </div>
         </div>
       </div>
 
       {/* Loading States */}
       <div className="!space-y-4">
-        <h3 className="text-sm font-medium text-white">Loading & Animation</h3>
+        <h3 className="text-fm-icon-active text-sm font-medium">
+          Loading & Animation
+        </h3>
         <div className="grid grid-cols-3 gap-6">
           <div className="text-center">
             <SiteLogoIcon className="!mx-auto h-12 w-12 animate-pulse" />
-            <span className="mt-2 text-xs text-white/60">Pulse</span>
+            <span className="text-fm-tertiary mt-2 text-xs">Pulse</span>
           </div>
           <div className="text-center">
             <SiteLogoIcon className="animate-logo-pulse !mx-auto h-12 w-12" />
-            <span className="mt-2 text-xs text-white/60">Custom Pulse</span>
+            <span className="text-fm-tertiary mt-2 text-xs">Custom Pulse</span>
           </div>
           <div className="text-center">
             <SiteLogoIcon className="animate-logo-glow !mx-auto h-12 w-12" />
-            <span className="mt-2 text-xs text-white/60">Glow Effect</span>
+            <span className="text-fm-tertiary mt-2 text-xs">Glow Effect</span>
           </div>
         </div>
       </div>
@@ -1166,8 +1225,8 @@ export const Playground: Story = {
     className: "",
   },
   render: (args) => (
-    <div className="flex h-64 min-h-dvh items-center justify-center rounded-lg bg-gradient-to-br from-gray-900 to-gray-800">
-      <div className="rounded-lg border border-white/10 bg-white/5 p-8">
+    <div className="from-fm-surface-primary to-fm-surface-secondary flex h-64 min-h-dvh items-center justify-center rounded-lg bg-linear-to-br">
+      <div className="border-fm-divider-secondary bg-fm-surface-secondary rounded-lg border p-8">
         <SiteLogoIcon {...args} />
       </div>
     </div>