docs: add mkdocs.yml for ReadTheDocs and Python version requirement

- Created mkdocs.yml with Material theme configuration
- Added navigation structure for all documentation
- Updated README badge to show Python >= 3.8 requirement
- Added Python version note in installation section

Author: 0xdps

README.md

@@ -8,7 +8,7 @@
 
 [![PyPI](https://img.shields.io/pypi/v/fakestack)](https://pypi.org/project/fakestack/)
 [![npm](https://img.shields.io/npm/v/fakestack)](https://www.npmjs.com/package/fakestack)
-[![Python](https://img.shields.io/pypi/pyversions/fakestack)](https://pypi.org/project/fakestack/)
+[![Python](https://img.shields.io/badge/python-%3E%3D3.8-blue)](https://pypi.org/project/fakestack/)
 [![Node](https://img.shields.io/node/v/fakestack)](https://www.npmjs.com/package/fakestack)
 [![Documentation](https://readthedocs.org/projects/fake-stack/badge/?version=latest)](https://fake-stack.readthedocs.io/)
 [![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
@@ -38,7 +38,7 @@ Generate databases from JSON schemas with realistic fake data. **10-50x faster**
 
 Choose your preferred package manager:
 
-**Python (pip)**
+**Python (pip)** - Requires Python >= 3.8
 ```bash
 pip install fakestack
 ```

mkdocs.yml

@@ -0,0 +1,105 @@
+site_name: Fakestack Documentation
+site_url: https://fake-stack.readthedocs.io/
+site_description: High-performance database generator with realistic fake data
+site_author: Devendra Pratap Singh
+repo_url: https://github.com/0xdps/fake-stack
+repo_name: 0xdps/fake-stack
+
+theme:
+  name: material
+  palette:
+    - scheme: default
+      primary: indigo
+      accent: indigo
+      toggle:
+        icon: material/brightness-7
+        name: Switch to dark mode
+    - scheme: slate
+      primary: indigo
+      accent: indigo
+      toggle:
+        icon: material/brightness-4
+        name: Switch to light mode
+  features:
+    - navigation.tabs
+    - navigation.sections
+    - navigation.top
+    - search.suggest
+    - search.highlight
+    - content.tabs.link
+    - content.code.copy
+  icon:
+    repo: fontawesome/brands/github
+
+plugins:
+  - search
+  - awesome-pages
+
+markdown_extensions:
+  - pymdownx.highlight:
+      anchor_linenums: true
+  - pymdownx.inlinehilite
+  - pymdownx.snippets
+  - pymdownx.superfences
+  - pymdownx.tabbed:
+      alternate_style: true
+  - admonition
+  - pymdownx.details
+  - pymdownx.emoji:
+      emoji_index: !!python/name:material.extensions.emoji.twemoji
+      emoji_generator: !!python/name:material.extensions.emoji.to_svg
+  - attr_list
+  - md_in_html
+  - tables
+  - toc:
+      permalink: true
+
+nav:
+  - Home: index.md
+  - Getting Started:
+      - Installation: getting-started.md
+      - Quick Start: getting-started.md#quick-start
+      - Basic Usage: getting-started.md#basic-usage
+  - Schema:
+      - Schema Reference: schema-reference.md
+      - Database Configuration: schema-reference.md#database-configuration
+      - Table Definitions: schema-reference.md#table-definitions
+      - Data Population: schema-reference.md#data-population
+  - Generators:
+      - Available Generators: generators.md
+      - Custom Generators: CUSTOM_GENERATORS.md
+      - Template Examples: TEMPLATE_EXAMPLES.md
+  - Databases:
+      - Database Support: databases.md
+      - SQLite: databases.md#sqlite
+      - MySQL: databases.md#mysql
+      - PostgreSQL: databases.md#postgresql
+      - MariaDB: databases.md#mariadb
+      - MS SQL Server: databases.md#ms-sql-server
+      - CockroachDB: databases.md#cockroachdb
+  - API Reference:
+      - Overview: api-reference.md
+      - Python API: api-reference.md#python-api
+      - Node.js API: api-reference.md#nodejs-api
+      - Go Core: api-reference.md#go-core
+  - Examples:
+      - Real-World Examples: examples.md
+      - E-commerce: examples.md#e-commerce
+      - Blog Platform: examples.md#blog-platform
+      - Social Network: examples.md#social-network
+  - Troubleshooting: troubleshooting.md
+  - Development:
+      - Contributing: ../CONTRIBUTING.md
+      - Development Setup: ../DEVELOPMENT.md
+      - Changelog: ../CHANGELOG.md
+
+extra:
+  social:
+    - icon: fontawesome/brands/github
+      link: https://github.com/0xdps/fake-stack
+    - icon: fontawesome/brands/python
+      link: https://pypi.org/project/fakestack/
+    - icon: fontawesome/brands/npm
+      link: https://www.npmjs.com/package/fakestack
+  version:
+    provider: mike