Skip to content

Repository files navigation

logo

Lotse

Minimalistic dark mode blogging and portfolio template made using NextJS and MDX.

Stars Forks License

Next.js React Tailwind CSS MDX

🔗 Demo: lotse.vercel.app


📸 Screenshots

screenshot post


Enhanced Features

  • 📦 Employs Content Collections for MDX compilation (fast and type-safe)
  • 🎨 Boasts an ultra-minimalistic design for a clean user experience
  • ⚡ Developed with NextJS 15, React 19 & TailwindCSS
  • 🚀 Achieves nearly perfect scores in Page Speed Insights
  • 🧮 Implements Katex for mathematical equation displays
  • 🔍 Optimized for SEO, enhancing visibility and accessibility

Quick start guide

  1. Fork this repo
  2. ⚙️ Modify blog.config.ts with your own site data
export const CONFIG = {
  title: "Your site title",
  description: "Minimalistic dark mode blogging template",
  baseURL: "URL of your site", // replace with your domain
  darkBackground: "#1a1a1a", // background color
  resume: {
    link: "/resume.pdf", // upload your resume in the /public folder
    show: true, // true or false
  },
  social: {
    github: "https://github.com/username",
    twitter: "https://x.com/username",
    ... any other social link...
  },
};
  1. 🖼️ Replace the app/favicon.ico using your own icon
  2. ✍️ Write your about in content/about.mdx
  3. 🌐 To deploy you can use Vercel or Netlify. import the repo and deploy.

📂 Post & Project structure

Check the content-collections.ts to see all fields.

📝 Creating a Post

To create a post, simply generate a .mdx file in the content/posts directory. Ensure the file name is user-friendly, such as securing-your-web-applications-best-practices-in-web-security.mdx.

---
title: "The title of your post (required)"
date: date of your post (YYYY-MM-DD format, also required)
draft: false (required)
description: "Optional description"
---

The title should be between " " to prevent conflicts, an example of this:

---
title: "Automation with Bash Streamlining Repetitive Tasks"
date: 2023-11-11
draft: false
---

For projects, the structure involves only the title. Create a .mdx file in the content/projects directory.

---
title: "The title of your project (required)"
---

🤝 Contributing

Contributions of any kind are appreciated. Feel free to fork the project and submit a pull request.


📄 License

This project is licensed under the MIT License

About

Minimalistic dark mode blogging and portfolio template made using NextJS & TailwindCSS (https://lotse.vercel.app/)

Topics

Resources

Stars

26 stars

Watchers

1 watching

Forks

Used by

Contributors

Languages