morethan-log

Next.js static blog using Notion as a Content Management System (CMS). Supports both Blog format Post as well as Page format for Resume. Deployed using Vercel.

Demo Blog | Demo Resume

Features

📒 Writing posts using notion

• No need of commiting to Github for posting anything to your website.
• Posts made on Notion are automaticaly updated on your site.

📄 Use as a page as resume

• Useful for generating full page sites using Notion.
• Can be used for Resume, Portfolios etc.

👀 SEO friendly

• Dynamically generates OG IMAGEs (thumbnails!) for posts. (og-image-korean).
• Dynamically creates sitemap for posts.

🤖 Customisable and Supports various plugin through CONFIG

• Your profile information can be updated through Config. (site.config.js)
• Plugins support includes, Google Analytics, Search Console and also Commenting using Github Issues(Utterances) or Cusdis.

📋 Table of Contents (TOC)

• Fast loading without delay timers
• Native implementation without external dependencies
• Responsive design that hides on mobile/tablet (≤1300px)
• Smooth scroll navigation with active section highlighting
• Memory efficient with caching and memoization
• Keyboard navigation and ARIA attributes support

Getting Started

1. Star this repo.

2. Fork the repo to your Profile.

3. Duplicate this Notion template, and Share to Web.

4. Copy the Web Link and keep note of the Notion Page Id from the Link which will be in this format [username.notion.site/NOTION_PAGE_ID?v=VERSION_ID].

5. Clone your forked repo and then customize site.config.js based on your preference.

6. Deploy on Vercel, with the following environment variables.

   • NOTION_PAGE_ID (Required): The Notion page Id got from the Share to Web URL. This is not the entire URL, but just the NOTION_PAGE_ID part as shown above.
   • NEXT_PUBLIC_GOOGLE_MEASUREMENT_ID : For Google analytics Plugin.
   • NEXT_PUBLIC_GOOGLE_SITE_VERIFICATION : For Google search console Plugin.
   • NEXT_PUBLIC_NAVER_SITE_VERIFICATION : For Naver search advisor Plugin.
   • NEXT_PUBLIC_UTTERANCES_REPO : For Utterances Plugin.

10 Steps to build your own morethan-log (by 23.06.23)

Click to see guide

0. Prepare Notion, Vercel account.

1. ⭐ Star and Fork this repo.

2. As you click the Notion template, you will see this notion page in your browser. Click Duplicate button(복제 in image) in right top.

3. And you will see notion page in notion app in your account.

4. Click Share and Publish in right top, and check web link. (Copy web link)

5. Modify site.config.js file in your forked repo.

💡 NOTE. I changed 2 RED PART

6. Move and login to vercel.

7. Build new project using Add New...

8. Import your forked morethan-log repository

9. Add Environment variabes to vercel project

10. Wait for the deployment to complete. After the deployment is successful, you should see an image like the one below.

🥳 Congratulations. Now check out your blog

Technical Documentation

Table of Contents (TOC) System

The blog includes a Table of Contents system for navigation within blog posts.

Architecture

The TOC system consists of three main components:

1. useTOC Hook (src/hooks/useTOC.ts)

   • Replaces the old tocbot-based implementation
   • Provides fast initialization without delay timers
   • Includes responsive optimization for mobile devices
   • Uses native browser APIs

2. TOC Utilities (src/libs/utils/toc.ts)

   • DOM traversal for heading extraction
   • Hierarchical TOC structure building
   • Caching for performance
   • Safe ID generation for Korean and special characters

3. TableOfContents Component (src/components/TableOfContents/index.tsx)

   • Native React implementation
   • Responsive design with automatic hiding on small screens
   • Smooth scroll navigation
   • Active section highlighting

Key Features

• Fast loading TOC
• Memory efficient with caching
• Responsive design (hidden on screens ≤1300px)
• Keyboard navigation and ARIA attributes
• IntersectionObserver for active section tracking

Type Definitions

// Core TOC item structure
export type TOCItem = {
  id: string
  title: string
  level: number
  children?: TOCItem[]
}

// Version with DOM caching
export type TOCItemWithCache = TOCItem & {
  element?: HTMLElement  // DOM element reference
  offsetTop?: number     // Cached scroll position
}

Usage

The TOC system is automatically integrated into blog posts. It will:

• Show when there are 3+ headings in the content
• Hide automatically on mobile/tablet devices
• Provide smooth scroll navigation
• Highlight the currently active section

Environment-based Logging

The system includes a logging utility (src/libs/utils/logger.ts) that:

• Disables console output in production
• Provides debugging information in development
• Supports different log levels (error, warn, info, debug)
• Can be reused across other components

FAQ

Click to see FAQ

Q1: If you finish making avatar.svg, How to make favicon.ico and apple-touch-icon.png?

A1: check out https://www.favicon-generator.org/

Q2: Is it necessary to set up a sitemap file?
A2: The system will dynamically create a sitemap.xml, so there is no need for manual setup.

Q3: Why don’t Notion posts update automatically?
A3: Please set the revalidateTime in site.config.js and observe how long it takes to update.

Q4: What should be entered for NEXT_PUBLIC_GOOGLE_MEASUREMENT_ID and NEXT_PUBLIC_GOOGLE_SITE_VERIFICATION in site.config.js? A4: You can check morethanmin#203. Please note that updates may take some time to take effect after setting.

If you encounter any other issues, please feel free to add them to the GitHub README to assist future users. We look forward to your contributions!

Contributing

Check out the Contributing Guide.

Contributors

Support

morethan-log is an MIT-licensed open source project. It can grow thanks to the sponsors and support from the amazing backers.

Sponsors

  

License

The MIT License.