Bloapi 🐧

API battery kit for nextjs blog

• Bloapi 🐧
• The Problem
• Let's Play Practical
• Perfect Fit for
• Kind of meta
  • required
  • optional
• Kind of data
• Features
  • Essential 📦
  • More 🚀
• Get started
• LICENSE

The Problem

1. To start nextjs blog, making own cms api is essential. But that's pretty annoying process.
2. Blog templates can solve this problem, but templates often contain too much unnecessary stuff.

Let's Play Practical

start with just what we need.

Api 🚀 + Essential feature 📦

Perfect Fit for

• Focus only on making UI
• Choose tech stack oneself
• Minimal, Customizable, Solid blog

Kind of meta

🚀 bloapi supports rich post meta option

required

---
title: post titlepreview: post previewauthor: post authorupdate: 2022/08/15 # < YYYY/MM/DD >color: "#A68A68"# < "{ HEX | rgba | rgb }" >tags: tag1, tag2 # split by comma
---

optional

---
series: javascript-1 # < {seriesTitle}-{order} >bannerUrl: /category/post # nextjs static image locationreference: ref1, ref2 # split by commapostpone: true # if true, post will not published
---

Kind of data

Let's look at the data we receive on each page by core api

1. main: pages/index.tsx

Link to 🔭: https://{deploy-url}/

interfaceMainPageProps{latestPost: MetaType[]// ✅ main-page latest post// 💡 types/post/meta.tsmainCategory: CategoryInfoType[]// ✅ main-page displaying category// 💡 types/category/index.ts}

2. category: pages/category.tsx

Link to 🔭: https://{deploy-url}/category

interfaceAllCategoryPageProps{allCategoryInfo: CategoryInfoType[]// ✅ all category of blog// 💡 types/category/index.ts}

3. profile: pages/profile.tsx

Link to 🔭: https://{deploy-url}/profile

interfaceProfilePageProps{profileSource: string// ✅ extracted source of {blog-dir}/profile/description.mdx}

4. {category}: pages/[category].tsx

Link to 🔭: https://{deploy-url}/{category}

interfaceCategoryPagePropsextendsCategoryInfoType{// ✅ specific category info// 💡 types/category/index.tslatestPost: MetaType[]// ✅ latest-post of specific category// 💡 types/post/meta.tslatestTag: string[]// ✅ latest-post-tag of specific categoryallSeries: SeriesType[]// ✅ series of specific category// 💡 types/post/series.ts}

5. {category}/{page}: pages/[category]/[page]/index.tsx

Link to 🔭: https://{deploy-url}/{category}/{page}/

interfacePaginatedCategoryPagePropsextendsCategoryInfoType{allPost: MetaType[]// ✅ paginated-post of specific category// 💡 types/post/meta.tsallTag: string[]// ✅ paginated-post-tag of specific categorypage: number// ✅ current page numberisLastPage: boolean}

6. {category}/{page}/{postTitle}: pages/[category]/[page]/[postTitle].tsx

Link to 🔭: https://{deploy-url}/{category}/{page}/{postTitle}

interfacePostPagePropsextendsPostWithControllerType{// ✅ specific post + controller [prev, next post]// 💡 types/post/index.tsseriesInfo: SeriesType|null// ✅ specific post's seriesInfo. nullable// 💡 types/post/series.ts}

Features

Essential 📦

1. MDX full support with mdx-bundler
2. CLI posting support
3. SEO optimized with next-seo
4. RSS/SITEMAP generation in scripts

More 🚀

1. First Load Js ⚡️ 44.5kb ⚡️, preact on production build
2. Toc object generation on server-side
3. Image optimized with next/image and support automatic-sizing
4. Google-analytics full support in party-town-thread
5. Code highlight with rehype-prism-plus
6. Math expressionoptional support with katex
7. Kind error message
8. Kind tsdoc. Read doc with cmd+mouse hover shortcut in vscode

Get started

Click 🐧 Use This Template or 🐧 git clone

LICENSE

MIT