Bloggrify

Getting started | Homepage

Bloggrify is built on top of

• Nuxt.js
• Tailwind CSS
• Nuxt-Content
• and other cool stuff (Hyvor Talk, Hakanai, etc...)

It is a static blog generator that uses markdown files to generate blog posts.

Discover all features on the official website

If you use this project and it saves you time. How about supporting it?

Contributing

I created this blog application because I know how tedious it is to assemble all the bricks needed to have an SEO-efficient blog, with a clean, accessible design, responsive, with features already integrated (comment system, rss feed, newsletter, sitemap etc...).

All this work, which can take days to do, I'll spare you - and it's free.

However, if you consider that you've really saved time, you might consider supporting this work. It's optional, but it will be much appreciated.

The first option is to offer me a virtual coffee representing the value of the time you've saved.

But you can also contribute in many other ways:

• by talking about this project on social networks, on your blog, with your colleagues.
• by giving this project a star on github
• by contributing to the open source project to improve it (see below)

10% of the benefits will be donated to the Unicef foundation, an organization that helps children in need all over the world.

Contributing to the project

Make sure to install the dependencies:

# npm
npm install

# pnpm
pnpm install

Development Server

Start the development server on http://localhost:3000

Running bloggrify alone without templates won't be really useful.

# npm
npm run dev

# pnpm
pnpm run dev

Editor Support

Visual Studio Code (VS Code)

This project includes VS Code configuration files to enhance the development experience:

• Recommended extensions for Nuxt, TailwindCSS, and TypeScript development.
• Debug and launch configurations for client and server to improve the debugging experience.

For more information on debugging in VS Code, visit the VS Code debugging documentation.

The launch configuration is based on the example provided in the Nuxt debugging guide.

These extensions are optional and maintained by their respective developers or the VSCode users community. Contributions to the selection and recommendation of these extensions are welcome!

JetBrains IDEs

You can also debug the project in JetBrains IDEs using the Nuxt provided example JetBrains IDEs debug configuration.

Production

Build the application for production:

# npm
npm run generate

# pnpm
pnpm run generate

Locally preview production build:

# npm
npm run preview

# pnpm
pnpm run preview

Release

Each commit should respect the conventional commit format.

The basic release process is as follows:

• Update the version in package.json
• create a tag with the version number
• push the tag to the repository
• publish the release on github
• publish the release on npm

In order to automate this process, you can use the following command:

# First, you need to install the changelogen package
npm install -g changelogen

# Then, you can run the following command to automate all the previous steps
npx changelogen --release --push && npm publish

In order to publish the release on npm, you need to be authenticated with the npm registry. You can do this by running npm login.
In order to publish the release on github, you need to be authenticated with the github registry. You can do this by creating a personal access token and setting it in your environment variables (GITHUB_TOKEN).