diff --git a/apps/docs/components/version-switcher.jsx b/apps/docs/components/version-switcher.jsx
new file mode 100644
index 00000000..cd0a590d
--- /dev/null
+++ b/apps/docs/components/version-switcher.jsx
@@ -0,0 +1,33 @@
+"use client";
+
+import { usePathname, useRouter } from 'next/navigation';
+
+const versions = [
+'v1','v2'
+];
+
+export default function VersionSwitcher() {
+  const pathname = usePathname(); 
+  const router = useRouter();
+
+  const currentVersion = pathname.split('/')[2] || 'v2';
+
+  const handleChange = (e) => {
+    const newVersion = e.target.value; 
+    router.push(`/docs/${newVersion}/getting-started`);
+  };
+
+  return (
+    <select
+      value={currentVersion}
+      onChange={handleChange}
+      style={{ borderWidth:1, paddingLeft: 8, paddingRight:8, paddingTop:4, paddingBottom:4, alignItems:'center' }}
+    >
+      {versions.map((version) => (
+        <option key={version} value={version}>
+          {version}
+        </option>
+      ))}
+    </select>
+  );
+}
diff --git a/apps/docs/next.config.mjs b/apps/docs/next.config.mjs
index 77ce54da..6c982fdb 100644
--- a/apps/docs/next.config.mjs
+++ b/apps/docs/next.config.mjs
@@ -59,12 +59,12 @@ export default withNextra({
     },
     {
       source: '/docs.([a-zA-Z-]+)',
-      destination: '/docs/getting-started',
+      destination: '/docs/v2/getting-started',
       statusCode: 302,
     },
     {
       source: '/docs',
-      destination: '/docs/getting-started',
+      destination: '/docs/v2/getting-started',
       statusCode: 302,
     },
   ],
diff --git a/apps/docs/pages/docs/Components/Inputs/_meta.en-US.json b/apps/docs/pages/docs/v1/Components/Inputs/_meta.en-US.json
similarity index 100%
rename from apps/docs/pages/docs/Components/Inputs/_meta.en-US.json
rename to apps/docs/pages/docs/v1/Components/Inputs/_meta.en-US.json
diff --git a/apps/docs/pages/docs/Components/Inputs/checkbox.en-US.mdx b/apps/docs/pages/docs/v1/Components/Inputs/checkbox.en-US.mdx
similarity index 100%
rename from apps/docs/pages/docs/Components/Inputs/checkbox.en-US.mdx
rename to apps/docs/pages/docs/v1/Components/Inputs/checkbox.en-US.mdx
diff --git a/apps/docs/pages/docs/Components/Inputs/input.en-US.mdx b/apps/docs/pages/docs/v1/Components/Inputs/input.en-US.mdx
similarity index 100%
rename from apps/docs/pages/docs/Components/Inputs/input.en-US.mdx
rename to apps/docs/pages/docs/v1/Components/Inputs/input.en-US.mdx
diff --git a/apps/docs/pages/docs/Components/Inputs/pininput.en-US.mdx b/apps/docs/pages/docs/v1/Components/Inputs/pininput.en-US.mdx
similarity index 100%
rename from apps/docs/pages/docs/Components/Inputs/pininput.en-US.mdx
rename to apps/docs/pages/docs/v1/Components/Inputs/pininput.en-US.mdx
diff --git a/apps/docs/pages/docs/Components/Inputs/radio.en-US.mdx b/apps/docs/pages/docs/v1/Components/Inputs/radio.en-US.mdx
similarity index 100%
rename from apps/docs/pages/docs/Components/Inputs/radio.en-US.mdx
rename to apps/docs/pages/docs/v1/Components/Inputs/radio.en-US.mdx
diff --git a/apps/docs/pages/docs/Components/Inputs/select.en-US.mdx b/apps/docs/pages/docs/v1/Components/Inputs/select.en-US.mdx
similarity index 100%
rename from apps/docs/pages/docs/Components/Inputs/select.en-US.mdx
rename to apps/docs/pages/docs/v1/Components/Inputs/select.en-US.mdx
diff --git a/apps/docs/pages/docs/Components/Inputs/slider.en-US.mdx b/apps/docs/pages/docs/v1/Components/Inputs/slider.en-US.mdx
similarity index 100%
rename from apps/docs/pages/docs/Components/Inputs/slider.en-US.mdx
rename to apps/docs/pages/docs/v1/Components/Inputs/slider.en-US.mdx
diff --git a/apps/docs/pages/docs/Components/Inputs/switch.en-US.mdx b/apps/docs/pages/docs/v1/Components/Inputs/switch.en-US.mdx
similarity index 100%
rename from apps/docs/pages/docs/Components/Inputs/switch.en-US.mdx
rename to apps/docs/pages/docs/v1/Components/Inputs/switch.en-US.mdx
diff --git a/apps/docs/pages/docs/Components/Inputs/textarea.en-US.mdx b/apps/docs/pages/docs/v1/Components/Inputs/textarea.en-US.mdx
similarity index 100%
rename from apps/docs/pages/docs/Components/Inputs/textarea.en-US.mdx
rename to apps/docs/pages/docs/v1/Components/Inputs/textarea.en-US.mdx
diff --git a/apps/docs/pages/docs/Components/Layout/_meta.en-US.json b/apps/docs/pages/docs/v1/Components/Layout/_meta.en-US.json
similarity index 100%
rename from apps/docs/pages/docs/Components/Layout/_meta.en-US.json
rename to apps/docs/pages/docs/v1/Components/Layout/_meta.en-US.json
diff --git a/apps/docs/pages/docs/Components/Layout/box.en-US.mdx b/apps/docs/pages/docs/v1/Components/Layout/box.en-US.mdx
similarity index 100%
rename from apps/docs/pages/docs/Components/Layout/box.en-US.mdx
rename to apps/docs/pages/docs/v1/Components/Layout/box.en-US.mdx
diff --git a/apps/docs/pages/docs/Components/Layout/center.en-US.mdx b/apps/docs/pages/docs/v1/Components/Layout/center.en-US.mdx
similarity index 100%
rename from apps/docs/pages/docs/Components/Layout/center.en-US.mdx
rename to apps/docs/pages/docs/v1/Components/Layout/center.en-US.mdx
diff --git a/apps/docs/pages/docs/Components/Layout/flex.en-US.mdx b/apps/docs/pages/docs/v1/Components/Layout/flex.en-US.mdx
similarity index 100%
rename from apps/docs/pages/docs/Components/Layout/flex.en-US.mdx
rename to apps/docs/pages/docs/v1/Components/Layout/flex.en-US.mdx
diff --git a/apps/docs/pages/docs/Components/Layout/hstack.en-US.mdx b/apps/docs/pages/docs/v1/Components/Layout/hstack.en-US.mdx
similarity index 100%
rename from apps/docs/pages/docs/Components/Layout/hstack.en-US.mdx
rename to apps/docs/pages/docs/v1/Components/Layout/hstack.en-US.mdx
diff --git a/apps/docs/pages/docs/Components/Layout/safeareabox.en-US.mdx b/apps/docs/pages/docs/v1/Components/Layout/safeareabox.en-US.mdx
similarity index 100%
rename from apps/docs/pages/docs/Components/Layout/safeareabox.en-US.mdx
rename to apps/docs/pages/docs/v1/Components/Layout/safeareabox.en-US.mdx
diff --git a/apps/docs/pages/docs/Components/Layout/scrollbox.en-US.mdx b/apps/docs/pages/docs/v1/Components/Layout/scrollbox.en-US.mdx
similarity index 100%
rename from apps/docs/pages/docs/Components/Layout/scrollbox.en-US.mdx
rename to apps/docs/pages/docs/v1/Components/Layout/scrollbox.en-US.mdx
diff --git a/apps/docs/pages/docs/Components/Layout/stack.en-US.mdx b/apps/docs/pages/docs/v1/Components/Layout/stack.en-US.mdx
similarity index 100%
rename from apps/docs/pages/docs/Components/Layout/stack.en-US.mdx
rename to apps/docs/pages/docs/v1/Components/Layout/stack.en-US.mdx
diff --git a/apps/docs/pages/docs/Components/Layout/tabs.en-US.mdx b/apps/docs/pages/docs/v1/Components/Layout/tabs.en-US.mdx
similarity index 100%
rename from apps/docs/pages/docs/Components/Layout/tabs.en-US.mdx
rename to apps/docs/pages/docs/v1/Components/Layout/tabs.en-US.mdx
diff --git a/apps/docs/pages/docs/Components/Layout/vstack.en-US.mdx b/apps/docs/pages/docs/v1/Components/Layout/vstack.en-US.mdx
similarity index 100%
rename from apps/docs/pages/docs/Components/Layout/vstack.en-US.mdx
rename to apps/docs/pages/docs/v1/Components/Layout/vstack.en-US.mdx
diff --git a/apps/docs/pages/docs/Components/Lists/_meta.en-US.json b/apps/docs/pages/docs/v1/Components/Lists/_meta.en-US.json
similarity index 100%
rename from apps/docs/pages/docs/Components/Lists/_meta.en-US.json
rename to apps/docs/pages/docs/v1/Components/Lists/_meta.en-US.json
diff --git a/apps/docs/pages/docs/Components/Lists/flashlist.en-US.mdx b/apps/docs/pages/docs/v1/Components/Lists/flashlist.en-US.mdx
similarity index 100%
rename from apps/docs/pages/docs/Components/Lists/flashlist.en-US.mdx
rename to apps/docs/pages/docs/v1/Components/Lists/flashlist.en-US.mdx
diff --git a/apps/docs/pages/docs/Components/Lists/list.en-US.mdx b/apps/docs/pages/docs/v1/Components/Lists/list.en-US.mdx
similarity index 100%
rename from apps/docs/pages/docs/Components/Lists/list.en-US.mdx
rename to apps/docs/pages/docs/v1/Components/Lists/list.en-US.mdx
diff --git a/apps/docs/pages/docs/Components/Lists/sectionlist.en-US.mdx b/apps/docs/pages/docs/v1/Components/Lists/sectionlist.en-US.mdx
similarity index 100%
rename from apps/docs/pages/docs/Components/Lists/sectionlist.en-US.mdx
rename to apps/docs/pages/docs/v1/Components/Lists/sectionlist.en-US.mdx
diff --git a/apps/docs/pages/docs/Components/Touchables/_meta.en-US.json b/apps/docs/pages/docs/v1/Components/Touchables/_meta.en-US.json
similarity index 100%
rename from apps/docs/pages/docs/Components/Touchables/_meta.en-US.json
rename to apps/docs/pages/docs/v1/Components/Touchables/_meta.en-US.json
diff --git a/apps/docs/pages/docs/Components/Touchables/button.en-US.mdx b/apps/docs/pages/docs/v1/Components/Touchables/button.en-US.mdx
similarity index 100%
rename from apps/docs/pages/docs/Components/Touchables/button.en-US.mdx
rename to apps/docs/pages/docs/v1/Components/Touchables/button.en-US.mdx
diff --git a/apps/docs/pages/docs/Components/Touchables/icon-button.en-US.mdx b/apps/docs/pages/docs/v1/Components/Touchables/icon-button.en-US.mdx
similarity index 100%
rename from apps/docs/pages/docs/Components/Touchables/icon-button.en-US.mdx
rename to apps/docs/pages/docs/v1/Components/Touchables/icon-button.en-US.mdx
diff --git a/apps/docs/pages/docs/Components/Touchables/pressable.en-US.mdx b/apps/docs/pages/docs/v1/Components/Touchables/pressable.en-US.mdx
similarity index 100%
rename from apps/docs/pages/docs/Components/Touchables/pressable.en-US.mdx
rename to apps/docs/pages/docs/v1/Components/Touchables/pressable.en-US.mdx
diff --git a/apps/docs/pages/docs/Components/Touchables/touchable-highlight.en-US.mdx b/apps/docs/pages/docs/v1/Components/Touchables/touchable-highlight.en-US.mdx
similarity index 100%
rename from apps/docs/pages/docs/Components/Touchables/touchable-highlight.en-US.mdx
rename to apps/docs/pages/docs/v1/Components/Touchables/touchable-highlight.en-US.mdx
diff --git a/apps/docs/pages/docs/Components/Touchables/touchable-opacity.en-US.mdx b/apps/docs/pages/docs/v1/Components/Touchables/touchable-opacity.en-US.mdx
similarity index 100%
rename from apps/docs/pages/docs/Components/Touchables/touchable-opacity.en-US.mdx
rename to apps/docs/pages/docs/v1/Components/Touchables/touchable-opacity.en-US.mdx
diff --git a/apps/docs/pages/docs/Components/Touchables/touchable-without-feedback.en-US.mdx b/apps/docs/pages/docs/v1/Components/Touchables/touchable-without-feedback.en-US.mdx
similarity index 100%
rename from apps/docs/pages/docs/Components/Touchables/touchable-without-feedback.en-US.mdx
rename to apps/docs/pages/docs/v1/Components/Touchables/touchable-without-feedback.en-US.mdx
diff --git a/apps/docs/pages/docs/Components/_meta.en-US.json b/apps/docs/pages/docs/v1/Components/_meta.en-US.json
similarity index 100%
rename from apps/docs/pages/docs/Components/_meta.en-US.json
rename to apps/docs/pages/docs/v1/Components/_meta.en-US.json
diff --git a/apps/docs/pages/docs/Components/avatar.en-US.mdx b/apps/docs/pages/docs/v1/Components/avatar.en-US.mdx
similarity index 100%
rename from apps/docs/pages/docs/Components/avatar.en-US.mdx
rename to apps/docs/pages/docs/v1/Components/avatar.en-US.mdx
diff --git a/apps/docs/pages/docs/Components/badge.en-US.mdx b/apps/docs/pages/docs/v1/Components/badge.en-US.mdx
similarity index 100%
rename from apps/docs/pages/docs/Components/badge.en-US.mdx
rename to apps/docs/pages/docs/v1/Components/badge.en-US.mdx
diff --git a/apps/docs/pages/docs/Components/divider.en-US.mdx b/apps/docs/pages/docs/v1/Components/divider.en-US.mdx
similarity index 100%
rename from apps/docs/pages/docs/Components/divider.en-US.mdx
rename to apps/docs/pages/docs/v1/Components/divider.en-US.mdx
diff --git a/apps/docs/pages/docs/Components/draggable-modal.en-US.mdx b/apps/docs/pages/docs/v1/Components/draggable-modal.en-US.mdx
similarity index 100%
rename from apps/docs/pages/docs/Components/draggable-modal.en-US.mdx
rename to apps/docs/pages/docs/v1/Components/draggable-modal.en-US.mdx
diff --git a/apps/docs/pages/docs/Components/icon.en-US.mdx b/apps/docs/pages/docs/v1/Components/icon.en-US.mdx
similarity index 100%
rename from apps/docs/pages/docs/Components/icon.en-US.mdx
rename to apps/docs/pages/docs/v1/Components/icon.en-US.mdx
diff --git a/apps/docs/pages/docs/Components/image.en-US.mdx b/apps/docs/pages/docs/v1/Components/image.en-US.mdx
similarity index 100%
rename from apps/docs/pages/docs/Components/image.en-US.mdx
rename to apps/docs/pages/docs/v1/Components/image.en-US.mdx
diff --git a/apps/docs/pages/docs/Components/modal.en-US.mdx b/apps/docs/pages/docs/v1/Components/modal.en-US.mdx
similarity index 100%
rename from apps/docs/pages/docs/Components/modal.en-US.mdx
rename to apps/docs/pages/docs/v1/Components/modal.en-US.mdx
diff --git a/apps/docs/pages/docs/Components/spinner.en-US.mdx b/apps/docs/pages/docs/v1/Components/spinner.en-US.mdx
similarity index 100%
rename from apps/docs/pages/docs/Components/spinner.en-US.mdx
rename to apps/docs/pages/docs/v1/Components/spinner.en-US.mdx
diff --git a/apps/docs/pages/docs/Components/text.en-US.mdx b/apps/docs/pages/docs/v1/Components/text.en-US.mdx
similarity index 100%
rename from apps/docs/pages/docs/Components/text.en-US.mdx
rename to apps/docs/pages/docs/v1/Components/text.en-US.mdx
diff --git a/apps/docs/pages/docs/Hooks/_meta.en-US.json b/apps/docs/pages/docs/v1/Hooks/_meta.en-US.json
similarity index 100%
rename from apps/docs/pages/docs/Hooks/_meta.en-US.json
rename to apps/docs/pages/docs/v1/Hooks/_meta.en-US.json
diff --git a/apps/docs/pages/docs/Hooks/useDisclosure.en-US.mdx b/apps/docs/pages/docs/v1/Hooks/useDisclosure.en-US.mdx
similarity index 100%
rename from apps/docs/pages/docs/Hooks/useDisclosure.en-US.mdx
rename to apps/docs/pages/docs/v1/Hooks/useDisclosure.en-US.mdx
diff --git a/apps/docs/pages/docs/Hooks/useMediaQuery.en-US.mdx b/apps/docs/pages/docs/v1/Hooks/useMediaQuery.en-US.mdx
similarity index 100%
rename from apps/docs/pages/docs/Hooks/useMediaQuery.en-US.mdx
rename to apps/docs/pages/docs/v1/Hooks/useMediaQuery.en-US.mdx
diff --git a/apps/docs/pages/docs/Hooks/useTheme.en-US.mdx b/apps/docs/pages/docs/v1/Hooks/useTheme.en-US.mdx
similarity index 100%
rename from apps/docs/pages/docs/Hooks/useTheme.en-US.mdx
rename to apps/docs/pages/docs/v1/Hooks/useTheme.en-US.mdx
diff --git a/apps/docs/pages/docs/Hooks/useToast.en-US.mdx b/apps/docs/pages/docs/v1/Hooks/useToast.en-US.mdx
similarity index 100%
rename from apps/docs/pages/docs/Hooks/useToast.en-US.mdx
rename to apps/docs/pages/docs/v1/Hooks/useToast.en-US.mdx
diff --git a/apps/docs/pages/docs/_meta.en-US.json b/apps/docs/pages/docs/v1/_meta.en-US.json
similarity index 100%
rename from apps/docs/pages/docs/_meta.en-US.json
rename to apps/docs/pages/docs/v1/_meta.en-US.json
diff --git a/apps/docs/pages/docs/customization.en-US.mdx b/apps/docs/pages/docs/v1/customization.en-US.mdx
similarity index 100%
rename from apps/docs/pages/docs/customization.en-US.mdx
rename to apps/docs/pages/docs/v1/customization.en-US.mdx
diff --git a/apps/docs/pages/docs/getting-started.en-US.mdx b/apps/docs/pages/docs/v1/getting-started.en-US.mdx
similarity index 100%
rename from apps/docs/pages/docs/getting-started.en-US.mdx
rename to apps/docs/pages/docs/v1/getting-started.en-US.mdx
diff --git a/apps/docs/pages/docs/responsive.en-US.mdx b/apps/docs/pages/docs/v1/responsive.en-US.mdx
similarity index 100%
rename from apps/docs/pages/docs/responsive.en-US.mdx
rename to apps/docs/pages/docs/v1/responsive.en-US.mdx
diff --git a/apps/docs/pages/docs/v2/_meta.en-US.json b/apps/docs/pages/docs/v2/_meta.en-US.json
new file mode 100644
index 00000000..f0e609e8
--- /dev/null
+++ b/apps/docs/pages/docs/v2/_meta.en-US.json
@@ -0,0 +1,3 @@
+{
+  "getting-started": "Getting Started"
+}
diff --git a/apps/docs/pages/docs/v2/getting-started.en-US.mdx b/apps/docs/pages/docs/v2/getting-started.en-US.mdx
new file mode 100644
index 00000000..212c74e8
--- /dev/null
+++ b/apps/docs/pages/docs/v2/getting-started.en-US.mdx
@@ -0,0 +1,63 @@
+---
+searchable: true
+---
+
+import { Link } from 'nextra-theme-docs';
+import { Callout, FileTree } from 'nextra/components';
+
+# Get started
+
+## Requirements
+
+<Callout type="warning" emoji="⚠️">
+  This library now needs `react-native-gesture-handler` to be installed inside the React Native project.
+  If you use Expo Go then you have nothing to do as Gesture Handler is integrated inside Expo SDK.
+  But if you use a Bare React Native project, please follow those instructions in first : https://docs.swmansion.com/react-native-gesture-handler/docs/fundamentals/installation/
+</Callout>
+
+## Installation
+
+With pnpm :
+
+```sh
+pnpm add react-native-ficus-ui
+```
+
+With npm :
+
+```sh
+npm install react-native-ficus-ui
+```
+
+With yarn :
+
+```sh
+yarn add react-native-ficus-ui
+```
+
+Then, install the pods for iOS :
+
+```sh
+cd ios && pod install
+```
+
+## Usage
+
+You need to wrap your root component inside ThemeProvider component from react-native-ficus-ui.
+
+```js
+import { AppRegistry } from 'react-native';
+import { ThemeProvider } from 'react-native-ficus-ui';
+
+import App from './src/App';
+
+export default function Main() {
+  return (
+    <ThemeProvider>
+      <App />
+    </ThemeProvider>
+  );
+}
+
+AppRegistry.registerComponent('main', () => Main);
+```
diff --git a/apps/docs/pages/index.en-US.mdx b/apps/docs/pages/index.en-US.mdx
index 3f29d904..f8bb4a75 100644
--- a/apps/docs/pages/index.en-US.mdx
+++ b/apps/docs/pages/index.en-US.mdx
@@ -23,7 +23,7 @@ import Image from 'next/image';
 
   <div className="flex justify-center mt-8">
     <div className="flex space-x-3">
-      <a href="/docs/getting-started">
+      <a href="/docs/v2/getting-started">
         <button className="bg-brand-500 text-white px-6 py-3 text-lg flex items-center rounded-lg shadow hover:bg-brand-600">
           Get started
 
diff --git a/apps/docs/theme.config.tsx b/apps/docs/theme.config.tsx
index 9809bb89..e6e85d3d 100644
--- a/apps/docs/theme.config.tsx
+++ b/apps/docs/theme.config.tsx
@@ -5,6 +5,7 @@ import type { DocsThemeConfig } from 'nextra-theme-docs';
 import { LocaleSwitch, useConfig, useTheme } from 'nextra-theme-docs';
 import type { ComponentProps, ReactElement } from 'react';
 import { Badge } from 'react-native-ficus-ui';
+import VersionSwitcher from '@components/version-switcher';
 
 export const FicusLogo = (props: ComponentProps<'svg'>): ReactElement => (
   <svg viewBox="0 0 200 250" width="30" xmlns="http://www.w3.org/2000/svg">
@@ -57,6 +58,7 @@ const FOOTER_LINK_TEXT_DARK = {
   ),
 };
 
+
 const config: DocsThemeConfig = {
   darkMode: true,
   docsRepositoryBase:
@@ -133,7 +135,12 @@ const config: DocsThemeConfig = {
     );
   },
   navbar: {
-    extraContent: LocaleSwitch,
+    extraContent: (
+      <>
+        <VersionSwitcher />
+        <LocaleSwitch />
+      </>
+    ),
   },
   nextThemes: {
     defaultTheme: 'light',
@@ -145,17 +152,21 @@ const config: DocsThemeConfig = {
   sidebar: {
     autoCollapse: true,
     defaultMenuCollapseLevel: 1,
-    titleComponent: ({ title, type }) =>
-      type === 'separator' ? (
+    titleComponent: ({ title, type }) => {
+      return type === 'separator' ? (
         <div className="flex items-center gap-2">
           <FicusLogo className="h-1.5 shrink-0" />
           {title}
         </div>
       ) : (
         <div className="flex flex-1 justify-between align-middle">
-          <span>{title}</span> {(title === 'Avatar' || title === 'Badge' || title === 'PinInput' || title === 'Responsive' || title === 'Slider' || title === 'Tabs' || title === 'IconButton' || title === 'DraggableModal') && <Badge colorScheme="purple" fontSize="sm" alignSelf="center">New</Badge>}
+          <span>{title}</span> 
+          {(title === 'Avatar' || title === 'Badge' || title === 'PinInput' || title === 'Responsive' || title === 'Slider' || title === 'Tabs' || title === 'IconButton' || title === 'DraggableModal') && (
+            <Badge colorScheme="purple" fontSize="sm" alignSelf="center">New</Badge>
+          )}
         </div>
-      ),
+      );
+    },
     toggleButton: true,
   },
   toc: {