diff --git a/README.md b/README.md
index 88cb0c5..7c70265 100644
--- a/README.md
+++ b/README.md
@@ -97,7 +97,7 @@ export default function Chat() {
 
 ### Custom Components
 
-You can use custom components by passing a `customComponents` prop to the `AnimatedMarkdown` component where the key is the regex pattern (ex. `/\{\{.*?\}\}/`) or HTML tag (ex. `MyComponent`) to match and the value is the component to render. Then just prompt your LLM to output the custom component syntax and it will be rendered with your custom component.
+You can use custom components by passing a `customComponents` prop to the `AnimatedMarkdown` component where the key is the regex pattern (ex. `/\{\{.*?\}\}/`) or HTML tag (ex. `MyComponent` for `<MyComponent />`) to match and the value is the component to render. Then just prompt your LLM to output the custom component syntax and it will be rendered with your custom component.
 
 #### Example
 
diff --git a/package.json b/package.json
index 9fe7a34..28aa66b 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "flowtoken",
-  "version": "1.0.17",
+  "version": "1.0.18",
   "description": "",
   "main": "dist/index.js",
   "scripts": {
diff --git a/src/components/AnimatedMarkdown.tsx b/src/components/AnimatedMarkdown.tsx
index a05998d..12d5915 100644
--- a/src/components/AnimatedMarkdown.tsx
+++ b/src/components/AnimatedMarkdown.tsx
@@ -120,6 +120,37 @@ export const customCodeRenderer = ({ animation, animationDuration, animationTimi
     ));
 };
 
+/**
+ * A React component that renders markdown content with customizable animations.
+ * 
+ * @component
+ * @example
+ * ```tsx
+ * <MarkdownAnimateText
+ *   content="# Hello World"
+ *   animation="fadeIn"
+ *   sep="word"
+ *   animationDuration="1s"
+ *   customComponents={{
+ *     // will match <custom id="123" />
+ *     'custom': ({ id }: { id: string }) => <strong>{id}</strong>,
+ *     '/regex/': ({ children }: { children: React.ReactNode }) => <li className="custom-li">{children}</li>,
+ *   }}
+ * />
+ * ```
+ * 
+ * @param {Object} props
+ * @param {string} props.content - The markdown content to render
+ * @param {'word' | 'char'} [props.sep='word'] - Separator for animation ('word' or 'char')
+ * @param {string | null} [props.animation='fadeIn'] - The animation name to apply (set to null to disable)
+ * @param {string} [props.animationDuration='1s'] - Duration of the animation
+ * @param {string} [props.animationTimingFunction='ease-in-out'] - Timing function for the animation
+ * @param {Object} [props.codeStyle=null] - Custom style for code blocks
+ * @param {Object} [props.htmlComponents={}] - Custom HTML component overrides
+ * @param {Object} [props.customComponents={}] - Custom component patterns to match and render
+ * 
+ * @returns {JSX.Element} Animated markdown content
+ */
 const MarkdownAnimateText: React.FC<SmoothTextProps> = ({
     content,
     sep = "word",
@@ -183,13 +214,13 @@ const MarkdownAnimateText: React.FC<SmoothTextProps> = ({
             // Add the substring before the match
             if (match.index > lastIndex) {
                 parts.push(<TokenizedText
-                        input={remainingText.slice(lastIndex, match.index)}
-                        sep={sep}
-                        animation={animation}
-                        animationDuration={animationDuration}
-                        animationTimingFunction={animationTimingFunction}
-                        animationIterationCount={1}
-                    />);
+                  input={remainingText.slice(lastIndex, match.index)}
+                  sep={sep}
+                  animation={animation}
+                  animationDuration={animationDuration}
+                  animationTimingFunction={animationTimingFunction}
+                  animationIterationCount={1}
+                />);
             }
             // Add the match itself - either as custom component or tokenized text
             const matchText = match[0];
@@ -211,7 +242,6 @@ const MarkdownAnimateText: React.FC<SmoothTextProps> = ({
                         }
                         return acc;
                     }, {});
-
                     parts.push(<TokenizedText
                         input={<CustomComponent 
                             key={match.index}