Skip to content

neerajadhav/floaty-hashnode-headless

 
 

Repository files navigation

Portfolio & Blog - Headless Hashnode Integration

This is my personal portfolio and blog website built using Next.js and integrated with Hashnode's Headless CMS. It serves as a platform to showcase my projects, share technical blogs, and highlight my skills.

🚀 Features

  • 📝 Headless Blog powered by Hashnode
  • 🌐 Fully Responsive UI for all devices
  • 🎨 Modern & Dark-Themed Design
  • 🏗 Built with Next.js for Performance
  • 🛠 Easy Deployment with Vercel
  • 🔗 Social & GitHub Integration

📸 Screenshots

🏠 Homepage

full1

📖 Blog Page

full2


🛠 How to Deploy

The recommended approach is deploying to Vercel. If you don't have an account, you can sign up for a free plan.

Steps:

  1. Fork this repository.
  2. Create a new project on Vercel and connect this repo.
  3. Choose Next.js as the framework preset.
  4. Set the following environment variables:
NEXT_PUBLIC_HASHNODE_GQL_ENDPOINT=https://gql.hashnode.com/
NEXT_PUBLIC_HASHNODE_PUBLICATION_HOST=your-hashnode-blog-url.hashnode.dev

Replace your-hashnode-blog-url with your actual Hashnode blog handle.

  1. Deploy and visit the auto-generated Vercel domain to confirm everything works.

🌎 Custom Domain Setup

If you have a custom domain, you can point NEXT_PUBLIC_HASHNODE_PUBLICATION_HOST to a different domain such as blog.yourdomain.com.


💻 Running Locally

  1. Clone the repository:
    git clone https://github.com/your-username/portfolio-blog.git
  2. Navigate into the directory:
    cd portfolio-blog
  3. Copy environment variables file:
    cp .env.example .env.local
  4. Install dependencies:
    yarn
  5. Run the development server:
    yarn dev
  6. Open http://localhost:3000 in your browser.

🎯 Tech Stack

  • Framework: Next.js
  • Styling: Tailwind CSS
  • CMS: Hashnode (Headless CMS)
  • Deployment: Vercel

📬 Contact

If you have any project ideas or want to collaborate, feel free to reach out!

🔗 Portfolio:

📜 License: MIT


© 2025 Neeraj Adhav. All rights reserved.

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 55.5%
  • TypeScript 44.0%
  • CSS 0.5%