{"id":19056357,"url":"https://github.com/chanmeng666/minimalist-good-post","last_synced_at":"2026-04-11T01:14:52.562Z","repository":{"id":259852889,"uuid":"879156556","full_name":"ChanMeng666/minimalist-good-post","owner":"ChanMeng666","description":"【One star = One happy developer doing a little dance 💃⭐️】A modern blog platform dedicated to minimalist living, built with Docusaurus and enhanced with interactive 3D visualizations. Sharing the art of simple, intentional living through curated articles and guides.","archived":false,"fork":false,"pushed_at":"2025-01-15T04:14:21.000Z","size":58860,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-15T06:13:27.240Z","etag":null,"topics":["blog","css","digital-minimalism","documentation","docusaurus","javascript","lifestyle","markdown","mdx","minimalism","personal-development","productivity","react","static-site","threejs"],"latest_commit_sha":null,"homepage":"https://minimalist-good-post.vercel.app","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ChanMeng666.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-10-27T06:23:15.000Z","updated_at":"2025-01-15T04:14:22.000Z","dependencies_parsed_at":"2024-10-28T12:34:22.445Z","dependency_job_id":"15dd843c-9c36-424d-aaf9-4ca9dd86f193","html_url":"https://github.com/ChanMeng666/minimalist-good-post","commit_stats":null,"previous_names":["chanmeng666/minimalist-good-post"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChanMeng666%2Fminimalist-good-post","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChanMeng666%2Fminimalist-good-post/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChanMeng666%2Fminimalist-good-post/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChanMeng666%2Fminimalist-good-post/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ChanMeng666","download_url":"https://codeload.github.com/ChanMeng666/minimalist-good-post/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240112424,"owners_count":19749640,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blog","css","digital-minimalism","documentation","docusaurus","javascript","lifestyle","markdown","mdx","minimalism","personal-development","productivity","react","static-site","threejs"],"created_at":"2024-11-08T23:49:09.494Z","updated_at":"2026-04-11T01:14:52.536Z","avatar_url":"https://github.com/ChanMeng666.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\u003ca name=\"readme-top\"\u003e\u003c/a\u003e\n\n[![Minimalist Living Banner](./static/img/minimalist-good-post-black.svg)](#)\n\n# 🌿 Minimalist Living\u003cbr/\u003e\u003ch3\u003eShare a Simple and Beautiful Way of Life\u003c/h3\u003e\n\nA modern blog platform dedicated to minimalist living, built with cutting-edge web technologies.\u003cbr/\u003e\nFeatures interactive 3D visualizations, comprehensive guides, and a thoughtfully designed minimalist interface.\u003cbr/\u003e\nOne-click **FREE** deployment of your minimalist lifestyle blog.\n\n[Live Site][live-site] · [Documentation][docs] · [Blog Posts][blog] · [Issues][github-issues-link]\n\n\u003cbr/\u003e\n\n[![🌿 Visit Live Site 🌿](https://gradient-svg-generator.vercel.app/api/svg?text=%F0%9F%8C%BFVisit%20Live%20Site%F0%9F%8C%BF\u0026color=000000\u0026height=60\u0026gradientType=radial\u0026duration=6s\u0026color0=ffffff\u0026template=pride-rainbow)][live-site]\n\n\u003cbr/\u003e\n\n\u003c!-- SHIELD GROUP --\u003e\n\n[![][github-release-shield]][github-release-link]\n[![][cloudflare-shield]][cloudflare-link]\n[![][github-stars-shield]][github-stars-link]\n[![][github-forks-shield]][github-forks-link]\n[![][github-issues-shield]][github-issues-link]\n[![][github-license-shield]][github-license-link]\u003cbr\u003e\n\n**Share Minimalist Living Repository**\n\n[![][share-x-shield]][share-x-link]\n[![][share-telegram-shield]][share-telegram-link]\n[![][share-whatsapp-shield]][share-whatsapp-link]\n[![][share-reddit-shield]][share-reddit-link]\n[![][share-linkedin-shield]][share-linkedin-link]\n\n\u003csup\u003e🌟 Pioneering the future of minimalist lifestyle sharing. Built for those seeking intentional living.\u003c/sup\u003e\n\n\u003c/div\u003e\n\n\u003e [!TIP]\n\u003e Add your project screenshots here to showcase the user interface and key features.\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/b28457c1-f27c-4ffa-9829-37707f744fa1\" alt=\"Main Dashboard\" width=\"800\"/\u003e\n  \u003cp\u003e\u003cem\u003eMain Dashboard - Clean, minimalist interface with interactive 3D elements\u003c/em\u003e\u003c/p\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/04cad0fd-7007-4937-9dfe-088ce46d8dab\" alt=\"Blog Interface\" width=\"800\"/\u003e\n  \u003cp\u003e\u003cem\u003eBlog Interface - Thoughtfully curated content on minimalist living\u003c/em\u003e\u003c/p\u003e\n\u003c/div\u003e\n\n## 🎬 Demo Video\n\n\u003e [!NOTE]\n\u003e Experience the interactive 3D models and smooth navigation in action.\n\n\u003cdiv align=\"center\"\u003e\n\nhttps://github.com/user-attachments/assets/804024d8-a380-4de7-875a-9ef2eca167b1\n\n*Interactive 3D models showcasing minimalist objects*\n\n\u003c/div\u003e\n\n**Tech Stack Badges:**\n\n\u003cdiv align=\"center\"\u003e\n\n \u003cimg src=\"https://img.shields.io/badge/docusaurus-%233ECC5F.svg?style=for-the-badge\u0026logo=docusaurus\u0026logoColor=white\"/\u003e\n \u003cimg src=\"https://img.shields.io/badge/react-%2320232a.svg?style=for-the-badge\u0026logo=react\u0026logoColor=%2361DAFB\"/\u003e\n \u003cimg src=\"https://img.shields.io/badge/threejs-black?style=for-the-badge\u0026logo=three.js\u0026logoColor=white\"/\u003e\n \u003cimg src=\"https://img.shields.io/badge/javascript-%23323330.svg?style=for-the-badge\u0026logo=javascript\u0026logoColor=%23F7DF1E\"/\u003e\n \u003cimg src=\"https://img.shields.io/badge/MDX-%23000000.svg?style=for-the-badge\u0026logo=mdx\u0026logoColor=white\"/\u003e\n \u003cimg src=\"https://img.shields.io/badge/cloudflare%20pages-%23F38020.svg?style=for-the-badge\u0026logo=cloudflarepages\u0026logoColor=white\"/\u003e\n\n\u003c/div\u003e\n\n\u003e [!IMPORTANT]\n\u003e This project demonstrates modern web development practices with Docusaurus and React. It combines interactive 3D graphics with content management to provide an immersive educational experience about minimalist living. Features include interactive 3D models, responsive design, dark/light themes, and comprehensive minimalism guides.\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003ckbd\u003e📑 Table of Contents\u003c/kbd\u003e\u003c/summary\u003e\n\n#### TOC\n\n- [🌿 Minimalist LivingShare a Simple and Beautiful Way of Life](#-minimalist-livingshare-a-simple-and-beautiful-way-of-life)\n  - [🎬 Demo Video](#-demo-video)\n      - [TOC](#toc)\n      - [](#)\n  - [🌟 Introduction](#-introduction)\n  - [✨ Key Features](#-key-features)\n    - [`1` Interactive 3D Models](#1-interactive-3d-models)\n    - [`2` Rich Content Library](#2-rich-content-library)\n    - [`*` Additional Features](#-additional-features)\n  - [🛠️ Tech Stack](#️-tech-stack)\n  - [🏗️ Architecture](#️-architecture)\n    - [System Architecture](#system-architecture)\n    - [Component Structure](#component-structure)\n    - [Content Structure](#content-structure)\n  - [⚡️ Performance](#️-performance)\n    - [Performance Metrics](#performance-metrics)\n  - [🚀 Getting Started](#-getting-started)\n    - [Prerequisites](#prerequisites)\n    - [Quick Installation](#quick-installation)\n    - [Development Mode](#development-mode)\n  - [🛳 Deployment](#-deployment)\n    - [`A` Cloudflare Pages Deployment](#a-cloudflare-pages-deployment)\n    - [`B` Docker Deployment](#b-docker-deployment)\n  - [📖 Usage Guide](#-usage-guide)\n    - [Content Management](#content-management)\n    - [Adding 3D Models](#adding-3d-models)\n    - [Customization](#customization)\n  - [🎨 Design Philosophy](#-design-philosophy)\n  - [📦 Project Structure](#-project-structure)\n  - [⌨️ Development](#️-development)\n    - [Local Development](#local-development)\n    - [Adding Features](#adding-features)\n    - [Testing](#testing)\n  - [🤝 Contributing](#-contributing)\n  - [📄 License](#-license)\n  - [👥 Author](#-author)\n\n####\n\n\u003cbr/\u003e\n\n\u003c/details\u003e\n\n## 🌟 Introduction\n\nWe are passionate about creating digital experiences that promote mindful, intentional living. This platform combines modern web technologies with minimalist design principles to share knowledge about simplifying life and finding joy in less.\n\nWhether you're beginning your minimalism journey or looking to deepen your practice, this platform offers interactive guides, thoughtful articles, and an immersive experience that embodies the minimalist philosophy.\n\n\u003e [!NOTE]\n\u003e - Node.js \u003e= 18.0 required\n\u003e - Modern browser with WebGL support for 3D models\n\u003e - No external accounts required for basic usage\n\n| [![][demo-shield-badge]][live-site]   | No installation required! Visit our live site to experience minimalist living content.                           |\n| :------------------------------------ | :--------------------------------------------------------------------------------------------- |\n\n\u003e [!TIP]\n\u003e **⭐ Star us** to receive all updates about new minimalist living content and features!\n\n\u003cdetails\u003e\n  \u003csummary\u003e\u003ckbd\u003e⭐ Star History\u003c/kbd\u003e\u003c/summary\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/svg?repos=ChanMeng666%2Fminimalist-good-post\u0026theme=dark\u0026type=Date\"\u003e\n    \u003cimg width=\"100%\" src=\"https://api.star-history.com/svg?repos=ChanMeng666%2Fminimalist-good-post\u0026type=Date\"\u003e\n  \u003c/picture\u003e\n\u003c/details\u003e\n\n## ✨ Key Features\n\n### `1` Interactive 3D Models\n\nExperience minimalist objects through immersive 3D visualizations. Our custom Three.js-powered ModelViewer component brings minimalist concepts to life with interactive models including pottery, plants, vinyl records, and furniture.\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/804024d8-a380-4de7-875a-9ef2eca167b1\" alt=\"3D Models Demo\" width=\"600\"/\u003e\n  \u003cp\u003e\u003cem\u003eInteractive 3D models floating with smooth animations\u003c/em\u003e\u003c/p\u003e\n\u003c/div\u003e\n\nKey capabilities include:\n- 🎯 **WebGL-Powered**: High-performance 3D rendering\n- 🎮 **Interactive Controls**: Orbit, rotate, and explore objects\n- 📱 **Responsive**: Optimized for all device sizes\n- ✨ **Smooth Animations**: Floating and rotation effects\n- 🎨 **Minimalist Objects**: Carefully curated 3D models\n\n[![][back-to-top]](#readme-top)\n\n### `2` Rich Content Library\n\nComprehensive guides and articles covering all aspects of minimalist living, from getting started to advanced concepts like digital minimalism and space organization.\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/b28457c1-f27c-4ffa-9829-37707f744fa1\" alt=\"Content Library\" width=\"800\"/\u003e\n  \u003cp\u003e\u003cem\u003eThoughtfully organized content with beautiful typography\u003c/em\u003e\u003c/p\u003e\n\u003c/div\u003e\n\n**Content Categories:**\n- **Beginner Guides**: Step-by-step introduction to minimalism\n- **Digital Minimalism**: Technology and mindful usage\n- **Home \u0026 Space**: Creating minimalist living environments\n- **Lifestyle**: Daily practices and mindset shifts\n\n[![][back-to-top]](#readme-top)\n\n### `*` Additional Features\n\nBeyond the core features, this platform includes:\n\n- [x] 🌓 **Dark/Light Themes**: Seamless theme switching with system preference detection\n- [x] 📱 **Mobile-First Design**: Fully responsive with touch-optimized 3D controls\n- [x] 🔍 **Full-Text Search**: Easy navigation through all content\n- [x] 📊 **Mermaid Diagrams**: Visual representation of minimalist concepts\n- [x] 📝 **MDX Support**: Enhanced markdown with React components\n- [x] 🎨 **Space Grotesk Typography**: Clean, modern font for optimal readability\n- [x] ⚡ **Fast Loading**: Optimized performance with Docusaurus\n- [x] 🛡️ **SEO Optimized**: Meta tags and structured data for better discovery\n\n\u003e ✨ More features are continuously being added to enhance the minimalist learning experience.\n\n\u003cdiv align=\"right\"\u003e\n\n[![][back-to-top]](#readme-top)\n\n\u003c/div\u003e\n\n## 🛠️ Tech Stack\n\n\u003cdiv align=\"center\"\u003e\n  \u003ctable\u003e\n    \u003ctr\u003e\n      \u003ctd align=\"center\" width=\"96\"\u003e\n        \u003cimg src=\"https://cdn.simpleicons.org/docusaurus\" width=\"48\" height=\"48\" alt=\"Docusaurus\" /\u003e\n        \u003cbr\u003eDocusaurus 3.5.2\n      \u003c/td\u003e\n      \u003ctd align=\"center\" width=\"96\"\u003e\n        \u003cimg src=\"https://cdn.simpleicons.org/react\" width=\"48\" height=\"48\" alt=\"React\" /\u003e\n        \u003cbr\u003eReact 18\n      \u003c/td\u003e\n      \u003ctd align=\"center\" width=\"96\"\u003e\n        \u003cimg src=\"https://cdn.simpleicons.org/threedotjs\" width=\"48\" height=\"48\" alt=\"Three.js\" /\u003e\n        \u003cbr\u003eThree.js\n      \u003c/td\u003e\n      \u003ctd align=\"center\" width=\"96\"\u003e\n        \u003cimg src=\"https://cdn.simpleicons.org/mdx\" width=\"48\" height=\"48\" alt=\"MDX\" /\u003e\n        \u003cbr\u003eMDX\n      \u003c/td\u003e\n      \u003ctd align=\"center\" width=\"96\"\u003e\n        \u003cimg src=\"https://cdn.simpleicons.org/mermaid\" width=\"48\" height=\"48\" alt=\"Mermaid\" /\u003e\n        \u003cbr\u003eMermaid\n      \u003c/td\u003e\n      \u003ctd align=\"center\" width=\"96\"\u003e\n        \u003cimg src=\"https://cdn.simpleicons.org/cloudflarepages\" width=\"48\" height=\"48\" alt=\"Cloudflare Pages\" /\u003e\n        \u003cbr\u003eCloudflare Pages\n      \u003c/td\u003e\n    \u003c/tr\u003e\n  \u003c/table\u003e\n\u003c/div\u003e\n\n**Frontend Stack:**\n- **Framework**: Docusaurus 3.5.2 for static site generation\n- **UI Library**: React 18 for component-based architecture\n- **3D Graphics**: Three.js with GLTFLoader and OrbitControls\n- **Content**: MDX for enhanced markdown capabilities\n- **Diagrams**: Mermaid for visual concept representation\n- **Icons**: Lucide React for consistent iconography\n\n**Styling \u0026 Design:**\n- **Typography**: Space Grotesk font family\n- **CSS**: Custom CSS with CSS variables for theming\n- **Responsive**: Mobile-first design principles\n- **Themes**: Light/dark mode with system preference detection\n\n**Development \u0026 Deployment:**\n- **Build Tool**: Docusaurus CLI with hot reloading\n- **Deployment**: Cloudflare Pages with global CDN\n- **Performance**: Optimized bundles and lazy loading\n- **SEO**: Automatic sitemap and meta tag generation\n\n\u003e [!TIP]\n\u003e Each technology was selected to create a fast, accessible, and visually appealing platform for sharing minimalist living content.\n\n## 🏗️ Architecture\n\n### System Architecture\n\n\u003e [!TIP]\n\u003e This architecture supports content-driven development and easy expansion, making it perfect for bloggers and content creators focused on minimalist living.\n\n```mermaid\ngraph TB\n    subgraph \"Frontend Layer\"\n        A[Docusaurus App] --\u003e B[React Components]\n        B --\u003e C[3D Model Viewer]\n        B --\u003e D[Content Pages]\n        C --\u003e E[Three.js Engine]\n    end\n    \n    subgraph \"Content Layer\"\n        F[MDX Blog Posts] --\u003e G[Markdown Docs]\n        G --\u003e H[Static Images]\n        H --\u003e I[3D Models]\n    end\n    \n    subgraph \"Build \u0026 Deploy\"\n        J[Docusaurus Build]\n        K[Static Site Generation]\n        L[Cloudflare Pages Deployment]\n    end\n    \n    A --\u003e F\n    F --\u003e J\n    J --\u003e K\n    K --\u003e L\n    \n    subgraph \"Assets\"\n        M[GLTF Models]\n        N[Images]\n        O[Fonts]\n    end\n    \n    E --\u003e M\n    D --\u003e N\n    B --\u003e O\n```\n\n### Component Structure\n\n```\nsrc/\n├── components/\n│   └── ModelViewer.js      # Three.js 3D model component\n├── css/\n│   └── custom.css          # Global styles and themes\n├── pages/\n│   ├── index.js           # Homepage with 3D models\n│   └── index.module.css   # Homepage-specific styles\n└── static/\n    ├── img/               # Static images and logos\n    └── models/            # 3D GLTF model files\n```\n\n### Content Structure\n\n```\nblog/                      # Blog posts (MDX/Markdown)\n├── 2024-10-31-minimalist-beginner-guide.md\n├── 2024-11-01-digital-minimalism.md\n├── 2024-11-01-minimalist-living-space.md\n└── ...\n\ndocs/                      # Documentation articles\n├── ultimate-simplicity.md\n├── digital-minimalism-guide.md\n├── minimalist-home.md\n└── img/                   # Article images organized by topic\n    ├── minimalist-home/\n    ├── digital-minimalism/\n    └── ...\n```\n\n## ⚡️ Performance\n\n### Performance Metrics\n\n**Key Metrics:**\n- ⚡ **95+ Lighthouse Score** across all categories\n- 🚀 **\u003c 2s** First Contentful Paint\n- 💨 **\u003c 1s** Time to Interactive\n- 📊 **99.9%** uptime reliability\n- 🎮 **60fps** 3D model interactions\n\n**Performance Optimizations:**\n- 🎯 **Static Site Generation**: Pre-built pages for instant loading\n- 📦 **Code Splitting**: Automatic bundle optimization by Docusaurus\n- 🖼️ **Image Optimization**: Responsive images with proper sizing\n- 🎨 **3D Model Optimization**: Compressed GLTF models with efficient loading\n\n\u003e [!NOTE]\n\u003e Performance metrics are continuously monitored and optimized for the best user experience.\n\n## 🚀 Getting Started\n\n### Prerequisites\n\n\u003e [!IMPORTANT]\n\u003e Ensure you have the following installed:\n\n- Node.js 18.0+ ([Download](https://nodejs.org/))\n- npm/yarn/pnpm package manager\n- Git ([Download](https://git-scm.com/))\n- Modern browser with WebGL support\n\n### Quick Installation\n\n**1. Clone Repository**\n\n```bash\ngit clone https://github.com/ChanMeng666/minimalist-good-post.git\ncd minimalist-good-post\n```\n\n**2. Install Dependencies**\n\n```bash\n# Using npm\nnpm install\n\n# Using yarn\nyarn install\n\n# Using pnpm (recommended)\npnpm install\n```\n\n**3. Start Development**\n\n```bash\nnpm start\n```\n\n🎉 **Success!** Open [http://localhost:3000](http://localhost:3000) to view the application.\n\n### Development Mode\n\n```bash\n# Start with hot reload\nnpm start\n\n# Build for production\nnpm run build\n\n# Serve production build locally\nnpm run serve\n\n# Clear cache\nnpm run clear\n```\n\n## 🛳 Deployment\n\n### `A` Cloudflare Pages Deployment\n\n**Why Cloudflare Pages:**\n- Global CDN with 300+ edge locations\n- Zero cold starts for static sites\n- Free SSL and unlimited bandwidth\n- Built-in DDoS protection\n\n```mermaid\ngraph LR\n    A[Local Build] --\u003e|npm run build| B[./build directory]\n    B --\u003e|wrangler pages deploy| C[Cloudflare Pages CDN]\n    C --\u003e D[minimalist-good-post.pages.dev]\n    \n    style A fill:#f9f9f9,stroke:#333\n    style C fill:#F38020,stroke:#333,color:#fff\n    style D fill:#4CAF50,stroke:#333,color:#fff\n```\n\n**Manual Deployment:**\n\n```bash\n# Install Wrangler CLI\nnpm i -g wrangler\n\n# Login to Cloudflare\nwrangler login\n\n# Build the site\nnpm run build\n\n# Deploy to Cloudflare Pages\nwrangler pages deploy ./build --project-name minimalist-good-post\n```\n\n**Git Integration (Recommended):**\n\n1. Go to [Cloudflare Dashboard](https://dash.cloudflare.com/) \u003e Pages\n2. Connect your GitHub repository\n3. Set build command: `npm run build`\n4. Set build output directory: `build`\n5. Every push to `main` will auto-deploy\n\n### `B` Docker Deployment\n\n```bash\n# Build Docker image\ndocker build -t minimalist-living .\n\n# Run container\ndocker run -p 3000:3000 minimalist-living\n```\n\n**docker-compose.yml:**\n\n```yaml\nversion: '3.8'\nservices:\n  app:\n    build: .\n    ports:\n      - \"3000:3000\"\n    environment:\n      - NODE_ENV=production\n```\n\n## 📖 Usage Guide\n\n### Content Management\n\n**Adding Blog Posts:**\n\n1. Create new `.md` or `.mdx` file in `blog/` directory\n2. Add frontmatter with metadata:\n\n```markdown\n---\nslug: your-post-slug\ntitle: Your Post Title\nauthors: [chanmeng]\ntags: [minimalism, lifestyle]\n---\n\nYour content here...\n```\n\n**Adding Documentation:**\n\n1. Create new `.md` file in `docs/` directory\n2. Add to sidebar configuration in `sidebars.js`\n\n### Adding 3D Models\n\n**1. Prepare Model:**\n- Use GLTF (.glb) format for best performance\n- Optimize model size and polygon count\n- Place in `static/models/` directory\n\n**2. Add to Component:**\n\n```jsx\n\u003cModelViewer\n  modelPath=\"/models/your-model.glb\"\n  width={500}\n  height={500}\n  title=\"Your Model Title\"\n/\u003e\n```\n\n### Customization\n\n**Themes and Styling:**\n\nEdit `src/css/custom.css` to customize:\n- Color schemes\n- Typography\n- Component styles\n- Dark/light theme variables\n\n**Site Configuration:**\n\nModify `docusaurus.config.js` for:\n- Site metadata\n- Navigation structure\n- Plugin configuration\n- Theme settings\n\n## 🎨 Design Philosophy\n\nOur design follows minimalist principles:\n\n- **Less is More**: Clean, uncluttered interfaces\n- **Intentional Spacing**: Generous whitespace for readability\n- **Typography First**: Space Grotesk for modern, clean text\n- **Interactive Elements**: 3D models that enhance, not distract\n- **Accessibility**: High contrast, keyboard navigation, screen reader support\n\n## 📦 Project Structure\n\n```\nminimalist-good-post/\n├── blog/                  # Blog posts (MDX/Markdown)\n├── docs/                  # Documentation articles\n│   └── img/              # Article images organized by topic\n├── src/\n│   ├── components/       # React components\n│   │   └── ModelViewer.js # 3D model viewer\n│   ├── css/             # Custom styles\n│   └── pages/           # Static pages\n├── static/\n│   ├── img/             # Static images and logos\n│   └── models/          # 3D GLTF model files\n├── docusaurus.config.js  # Main configuration\n├── sidebars.js          # Documentation sidebar\n└── package.json         # Dependencies and scripts\n```\n\n## ⌨️ Development\n\n### Local Development\n\n**Setup Development Environment:**\n\n```bash\n# Clone and install\ngit clone https://github.com/ChanMeng666/minimalist-good-post.git\ncd minimalist-good-post\nnpm install\n\n# Start development server\nnpm start\n```\n\n### Adding Features\n\n**1. New 3D Models:**\n- Add GLTF models to `static/models/`\n- Import in components using `ModelViewer`\n- Configure lighting and controls as needed\n\n**2. New Content Types:**\n- Create new document categories in `docs/`\n- Configure sidebar in `sidebars.js`\n- Add appropriate styling in `custom.css`\n\n### Testing\n\n```bash\n# Build test\nnpm run build\n\n# Serve locally\nnpm run serve\n\n# Clear cache if needed\nnpm run clear\n```\n\n## 🤝 Contributing\n\nWe welcome contributions! Here's how you can help improve this minimalist living platform:\n\n**Content Contributions:**\n- 📝 **Articles**: Share your minimalism journey\n- 🖼️ **Images**: Add inspiring minimalist photography\n- 🎨 **3D Models**: Contribute minimalist object models\n- 🐛 **Bug Reports**: Help us improve the experience\n\n**Development Contributions:**\n- Follow React and Docusaurus best practices\n- Maintain minimalist design principles\n- Add tests for new components\n- Update documentation\n\n**Pull Request Process:**\n1. Fork the repository\n2. Create feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit changes (`git commit -m 'Add amazing feature'`)\n4. Push to branch (`git push origin feature/amazing-feature`)\n5. Open Pull Request\n\n[![][pr-welcome-shield]][pr-welcome-link]\n\n\u003ca href=\"https://github.com/ChanMeng666/minimalist-good-post/graphs/contributors\" target=\"_blank\"\u003e\n  \u003ctable\u003e\n    \u003ctr\u003e\n      \u003cth colspan=\"2\"\u003e\n        \u003cbr\u003e\u003cimg src=\"https://contrib.rocks/image?repo=ChanMeng666/minimalist-good-post\"\u003e\u003cbr\u003e\u003cbr\u003e\n      \u003c/th\u003e\n    \u003c/tr\u003e\n  \u003c/table\u003e\n\u003c/a\u003e\n\n## 📄 License\n\nThis project is licensed under the Apache-2.0 License - see the [LICENSE](LICENSE) file for details.\n\n**Open Source Benefits:**\n- ✅ Commercial use allowed\n- ✅ Modification allowed\n- ✅ Distribution allowed\n- ✅ Private use allowed\n\n## 👥 Author\n\n\u003cdiv align=\"center\"\u003e\n  \u003ctable\u003e\n    \u003ctr\u003e\n      \u003ctd align=\"center\"\u003e\n        \u003ca href=\"https://github.com/ChanMeng666\"\u003e\n          \u003cimg src=\"https://github.com/ChanMeng666.png?size=100\" width=\"100px;\" alt=\"Chan Meng\"/\u003e\n          \u003cbr /\u003e\n          \u003csub\u003e\u003cb\u003eChan Meng\u003c/b\u003e\u003c/sub\u003e\n        \u003c/a\u003e\n        \u003cbr /\u003e\n        \u003csmall\u003eCreator \u0026 Lead Developer\u003c/small\u003e\n      \u003c/td\u003e\n    \u003c/tr\u003e\n  \u003c/table\u003e\n\u003c/div\u003e\n\n**Chan Meng**\n- \u003cimg src=\"https://cdn.simpleicons.org/linkedin/0A66C2\" width=\"16\" height=\"16\"\u003e LinkedIn: [chanmeng666](https://www.linkedin.com/in/chanmeng666/)\n- \u003cimg src=\"https://cdn.simpleicons.org/github/181717\" width=\"16\" height=\"16\"\u003e GitHub: [ChanMeng666](https://github.com/ChanMeng666)\n- \u003cimg src=\"https://cdn.simpleicons.org/gmail/EA4335\" width=\"16\" height=\"16\"\u003e Email: [chanmeng.dev@gmail.com](mailto:chanmeng.dev@gmail.com)\n- \u003cimg src=\"https://cdn.simpleicons.org/internetexplorer/0078D4\" width=\"16\" height=\"16\"\u003e Website: [chanmeng.org](https://chanmeng.org/)\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\u003cstrong\u003e🌿 Sharing the Art of Minimalist Living 🌟\u003c/strong\u003e\n\u003cbr/\u003e\n\u003cem\u003eEmpowering intentional living through technology\u003c/em\u003e\n\u003cbr/\u003e\u003cbr/\u003e\n\n⭐ **Star us on GitHub** • 📖 **Read the Articles** • 🐛 **Report Issues** • 💡 **Share Ideas** • 🤝 **Contribute**\n\n\u003cbr/\u003e\u003cbr/\u003e\n\n**Built with ❤️ for the minimalist community**\n\n\u003cimg src=\"https://img.shields.io/github/stars/ChanMeng666/minimalist-good-post?style=social\" alt=\"GitHub stars\"\u003e\n\u003cimg src=\"https://img.shields.io/github/forks/ChanMeng666/minimalist-good-post?style=social\" alt=\"GitHub forks\"\u003e\n\u003cimg src=\"https://img.shields.io/github/watchers/ChanMeng666/minimalist-good-post?style=social\" alt=\"GitHub watchers\"\u003e\n\n\u003c/div\u003e\n\n---\n\n\u003c!-- LINK DEFINITIONS --\u003e\n\n[back-to-top]: https://img.shields.io/badge/-BACK_TO_TOP-151515?style=flat-square\n\n\u003c!-- Project Links --\u003e\n[live-site]: https://minimalist-good-post.pages.dev\n[docs]: https://minimalist-good-post.pages.dev/docs/ultimate-simplicity\n[blog]: https://minimalist-good-post.pages.dev/blog\n\n\u003c!-- GitHub Links --\u003e\n[github-issues-link]: https://github.com/ChanMeng666/minimalist-good-post/issues\n[github-stars-link]: https://github.com/ChanMeng666/minimalist-good-post/stargazers\n[github-forks-link]: https://github.com/ChanMeng666/minimalist-good-post/forks\n[github-contributors-link]: https://github.com/ChanMeng666/minimalist-good-post/contributors\n[github-release-link]: https://github.com/ChanMeng666/minimalist-good-post/releases\n[pr-welcome-link]: https://github.com/ChanMeng666/minimalist-good-post/pulls\n[github-license-link]: https://github.com/ChanMeng666/minimalist-good-post/blob/main/LICENSE\n\n\u003c!-- Shield Badges --\u003e\n[github-release-shield]: https://img.shields.io/github/v/release/ChanMeng666/minimalist-good-post?color=369eff\u0026labelColor=black\u0026logo=github\u0026style=flat-square\n[cloudflare-shield]: https://img.shields.io/badge/cloudflare%20pages-online-F38020?labelColor=black\u0026logo=cloudflarepages\u0026style=flat-square\n[cloudflare-link]: https://minimalist-good-post.pages.dev\n[github-contributors-shield]: https://img.shields.io/github/contributors/ChanMeng666/minimalist-good-post?color=c4f042\u0026labelColor=black\u0026style=flat-square\n[github-forks-shield]: https://img.shields.io/github/forks/ChanMeng666/minimalist-good-post?color=8ae8ff\u0026labelColor=black\u0026style=flat-square\n[github-stars-shield]: https://img.shields.io/github/stars/ChanMeng666/minimalist-good-post?color=ffcb47\u0026labelColor=black\u0026style=flat-square\n[github-issues-shield]: https://img.shields.io/github/issues/ChanMeng666/minimalist-good-post?color=ff80eb\u0026labelColor=black\u0026style=flat-square\n[github-license-shield]: https://img.shields.io/badge/license-Apache--2.0-white?labelColor=black\u0026style=flat-square\n[pr-welcome-shield]: https://img.shields.io/badge/🤝_PRs_welcome-%E2%86%92-ffcb47?labelColor=black\u0026style=for-the-badge\n\n\u003c!-- Badge Variants --\u003e\n[demo-shield-badge]: https://img.shields.io/badge/TRY%20DEMO-ONLINE-F38020?labelColor=black\u0026logo=cloudflarepages\u0026style=for-the-badge\n\n\u003c!-- Social Share Links --\u003e\n[share-x-link]: https://x.com/intent/tweet?hashtags=minimalism,opensource\u0026text=Check%20out%20this%20amazing%20minimalist%20living%20platform\u0026url=https%3A%2F%2Fgithub.com%2FChanMeng666%2Fminimalist-good-post\n[share-telegram-link]: https://t.me/share/url?text=Check%20out%20this%20minimalist%20living%20platform\u0026url=https%3A%2F%2Fgithub.com%2FChanMeng666%2Fminimalist-good-post\n[share-whatsapp-link]: https://api.whatsapp.com/send?text=Check%20out%20this%20minimalist%20living%20platform%20https%3A%2F%2Fgithub.com%2FChanMeng666%2Fminimalist-good-post\n[share-reddit-link]: https://www.reddit.com/submit?title=Amazing%20Minimalist%20Living%20Platform\u0026url=https%3A%2F%2Fgithub.com%2FChanMeng666%2Fminimalist-good-post\n[share-linkedin-link]: https://linkedin.com/sharing/share-offsite/?url=https://github.com/ChanMeng666/minimalist-good-post\n\n[share-x-shield]: https://img.shields.io/badge/-share%20on%20x-black?labelColor=black\u0026logo=x\u0026logoColor=white\u0026style=flat-square\n[share-telegram-shield]: https://img.shields.io/badge/-share%20on%20telegram-black?labelColor=black\u0026logo=telegram\u0026logoColor=white\u0026style=flat-square\n[share-whatsapp-shield]: https://img.shields.io/badge/-share%20on%20whatsapp-black?labelColor=black\u0026logo=whatsapp\u0026logoColor=white\u0026style=flat-square\n[share-reddit-shield]: https://img.shields.io/badge/-share%20on%20reddit-black?labelColor=black\u0026logo=reddit\u0026logoColor=white\u0026style=flat-square\n[share-linkedin-shield]: https://img.shields.io/badge/-share%20on%20linkedin-black?labelColor=black\u0026logo=linkedin\u0026logoColor=white\u0026style=flat-square\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchanmeng666%2Fminimalist-good-post","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchanmeng666%2Fminimalist-good-post","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchanmeng666%2Fminimalist-good-post/lists"}