{"id":26830858,"url":"https://github.com/loke-dev/nextjs-mdx-blog-template","last_synced_at":"2025-03-30T14:18:00.110Z","repository":{"id":285159145,"uuid":"957034363","full_name":"loke-dev/nextjs-mdx-blog-template","owner":"loke-dev","description":"nextjs-mdx-blog-template.vercel.app","archived":false,"fork":false,"pushed_at":"2025-03-29T22:22:38.000Z","size":127,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-29T23:19:07.048Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://nextjs-mdx-blog-template.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/loke-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"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":"2025-03-29T11:52:33.000Z","updated_at":"2025-03-29T22:22:41.000Z","dependencies_parsed_at":"2025-03-29T23:29:28.320Z","dependency_job_id":null,"html_url":"https://github.com/loke-dev/nextjs-mdx-blog-template","commit_stats":null,"previous_names":["loke-dev/nextjs-mdx-blog-template"],"tags_count":0,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/loke-dev%2Fnextjs-mdx-blog-template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/loke-dev%2Fnextjs-mdx-blog-template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/loke-dev%2Fnextjs-mdx-blog-template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/loke-dev%2Fnextjs-mdx-blog-template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/loke-dev","download_url":"https://codeload.github.com/loke-dev/nextjs-mdx-blog-template/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246326761,"owners_count":20759439,"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":[],"created_at":"2025-03-30T14:17:59.608Z","updated_at":"2025-03-30T14:18:00.104Z","avatar_url":"https://github.com/loke-dev.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Next.js MDX Blog Template\n\nA modern, minimalist blog template built with Next.js, MDX, and Tailwind CSS. Perfect for developers who want to share their thoughts and showcase their work.\n\n\u003cimg width=\"1251\" alt=\"Image\" src=\"https://github.com/user-attachments/assets/8a263c60-778a-404d-bca5-b9e44cdfedc6\" /\u003e\n\n## ✨ Features\n\n- 🚀 **Next.js 15** with App Router\n- ⚡ **React 19** with Server Components\n- 🎨 **Tailwind CSS 4** for styling\n- 🧩 **shadcn/ui components** via Radix UI\n- 🌙 **Dark/Light mode** with next-themes\n- 📝 **MDX support** for blog posts\n- 🔍 **SEO optimized** with metadata\n- 📊 **Typed** with TypeScript\n- 🧹 **Linting** with ESLint\n- 💅 **Code formatting** with Prettier\n- 🦮 **Accessibility** focused design\n- 🏎️ **Performance optimized**\n- 📱 **Responsive** on all devices\n- 🏃🏻‍♂️‍➡️ **Animations** with Motion\n- 🎞️ **View Transitions API** support\n- 🔒 **Code quality** with Husky \u0026 lint-staged\n\n## 🧰 Tech Stack\n\n- [Next.js 15](https://nextjs.org/)\n- [React 19](https://react.dev/)\n- [TypeScript](https://www.typescriptlang.org/)\n- [Tailwind CSS 4](https://tailwindcss.com/)\n- [Radix UI](https://radix-ui.com/)\n- [Lucide Icons](https://lucide.dev/)\n- [MDX](https://mdxjs.com/) for blog posts\n- [Shiki](https://shiki.style/) for code highlighting\n- [Geist Font](https://vercel.com/font) for typography\n\n## 📋 Prerequisites\n\n- [Node.js](https://nodejs.org/en/) (v20 or higher)\n- [pnpm](https://pnpm.io/) (v8 or higher)\n\n## 🚀 Getting Started\n\n### Installation\n\n1. Clone this repository\n\n   ```bash\n   git clone https://github.com/loke-dev/nextjs-mdx-blog-template my-website\n   cd my-website\n   ```\n\n2. Install dependencies\n\n   ```bash\n   pnpm install\n   ```\n\n3. Start the development server\n\n   ```bash\n   pnpm dev\n   ```\n\n4. Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.\n\n## 📁 Project Structure\n\n```\n/\n├── public/           # Static assets\n├── src/\n│   ├── app/          # App router pages\n│   ├── components/   # React components\n│   │   ├── mdx/      # MDX-specific components\n│   │   └── ui/       # UI components (shadcn)\n│   ├── lib/          # Utility functions\n│   ├── posts/        # MDX blog posts\n│   ├── styles/       # Global styles\n│   └── types/        # TypeScript types\n├── .eslintrc.js      # ESLint configuration\n├── .prettierrc       # Prettier configuration\n├── next.config.ts    # Next.js configuration\n├── tailwind.config.ts # Tailwind CSS configuration\n└── tsconfig.json     # TypeScript configuration\n```\n\n## 📝 Usage\n\n### Creating Blog Posts\n\nAdd new MDX files to the `src/posts` directory:\n\n```mdx\n---\ntitle: My New Post\ndate: 2024-03-25\ndescription: A description of my new post\n---\n\n# My New Post\n\nThis is the content of my post written in MDX.\n```\n\n### Customization\n\n- Update site metadata in `src/app/layout.tsx`\n- Modify the theme in `src/styles/globals.css`\n- Add or modify components in `src/components`\n- Update pages in `src/app` directory\n\n## 🛠️ Development\n\n```bash\n# Run development server\npnpm dev\n\n# Build for production\npnpm build\n\n# Start production server\npnpm start\n\n# Run linting\npnpm lint\n\n# Format code\npnpm format\n```\n\n## 🚢 Deployment\n\nThis template is optimized for deployment on Vercel, but can be deployed on any platform that supports Next.js.\n\n[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https://github.com/loke-dev/nextjs-mdx-blog-template)\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n## 🙏 Acknowledgements\n\n- [Next.js](https://nextjs.org/) team for the incredible framework\n- [Vercel](https://vercel.com/) for hosting and deployment\n- [shadcn/ui](https://ui.shadcn.com/) for the beautiful components\n- [Tailwind CSS](https://tailwindcss.com/) for the utility-first CSS framework\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Floke-dev%2Fnextjs-mdx-blog-template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Floke-dev%2Fnextjs-mdx-blog-template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Floke-dev%2Fnextjs-mdx-blog-template/lists"}