shikmaru / blog

📒 Responsive blog with robust search, tag filtering, and newsletter.

📝 Frainer's Blog

Personal blog developed with Next.js App Router and TypeScript where I write about tech, projects, and whatever else I'm thinking about! Here you will find articles about web development, software engineering, and many more geeky things in the world of programming.

📦 Main Technologies

                                   

🚀 Key Features

• Responsive Design: Adapts seamlessly to various screen sizes.

• Animations: Features subtle entry animations and scroll-based animations, all crafted entirely with CSS.

• RSS Feed: Offers a comprehensive feed for subscription with any RSS reader to keep you updated.

• Search Functionality: Includes a search feature to easily find any article by title, description, tags, or content.

• Tag Filtering: Allows filtering articles based on their corresponding tags.

• Newsletter: Also provides the option to subscribe to the newsletter and receive articles by email upon publication.

• Article Visits: Records the number of visits each article receives in a database and displays the count.

🏁 Requirements

Before starting, you need to have Git and Node.js v18 or heigher installed.

🍿 How to Run Locally?

# Clone this project
    $ git clone https://github.com/fraineralex/blog.git
# Access
    $ cd blog

Create a .env file similar to .env.example.

Then

# Install dependencies
    $ pnpm install
# Run the project
    $ pnpm dev

Open http://localhost:3000 with your browser to see the result.

💡 Improvements

• Table of Contents Section: Introduce a dedicated section on the reading page to display the table of contents.

• Performance Boost: Enhance overall performance, aiming to surpass the current 66% rating in the home page.

• Expand Content Categories: Add more sections such as podcasts, books, and tools that I use.

• Spanish Translation: Include a Spanish translation for the entire site, in conjunction with the articles.

• Light/Dark Mode Switch: Provide the ability to switch between light and dark modes for a personalized reading experience.

🤝 Contributions

Thank you for exploring my blog! If you find the structure or features useful, feel free to use the template for your own project. Moreover, I invite you to contribute to the development! If you have ideas, corrections, or improvements, open an issue or send a pull request. Your collaboration is welcome and appreciated! 🚀