Liquid Glass Blog Template Release & Best Practices

Key Features

• Built with Next.js & Tailwind CSS for high performance and responsive design
• Markdown-based content management with categories, tags, code highlighting, and SEO optimization
• Theme customization, social sharing, and automatic OG image generation
• Simple content structure, easy to extend and maintain

How to Use

1. Clone the repository:

   ShellCopy
   git clone https://github.com/clark-ioe/liquid-glass-blog.git
   

2. Install dependencies:

   ShellCopy
   pnpm install
   

3. Start development server:

   ShellCopy
   pnpm dev
   

4. Add Markdown posts under content/posts to automatically generate category and tag pages.

For detailed configuration and feature guides, visit the online documentation: https://liquid-glass-blog.vercel.app/

Code Management & Iteration

• This template is actively maintained. It is recommended to set this repository as your upstream to easily sync new features and fixes.
• Fork for custom development and periodically pull updates from upstream.

Branch Management Best Practices

To develop based on this project and keep up with future updates:

• Fork this repository to your own GitHub account for custom development.
• Set the original repo as your upstream to easily fetch new features and bug fixes:

  ShellCopy
  git remote add upstream https://github.com/clark-ioe/liquid-glass-blog.git
  git fetch upstream
  git merge upstream/main
  # or use rebase if preferred
  git rebase upstream/main
  

• Keep your main branch stable and production-ready.
• Develop new features in feature/xxx branches, then merge into main.
• Use hotfix/xxx branches for urgent bug fixes.
• Regularly sync with upstream to avoid large codebase divergence and benefit from ongoing improvements.

Recommended Reading

• Content Structure & Markdown Conventions
• Categories & Tags Best Practices
• Theme Customization & Density Settings
• SEO & Social Sharing
• Deployment to Vercel

For more, check the online docs or browse the content/posts directory.

---

Feel free to submit issues or PRs for feedback and improvements!