Introduction
Configuration
Learn how to configure your blog.
There are three configuration files in the blog:
app.config.tsin the root of the projectnuxt.config.tsin the root of the project.envin the root of the project
app.config.ts
This is the main configuration file, and where you configure almost everything about your blog.
You can configure
- the url and SEO settings (indexing, AI crawlers),
- the title,
- the description,
- the logo,
- the social networks (twitter, bluesky, mastodon, youtube, linkedin, facebook, instagram, github) for the website
- the top menu,
- the list of authors
| Key | Type | Default | Description |
|---|---|---|---|
url | string | https://www.example.com | The public url of the website. Drives the canonical tags, og:url, the sitemap and the RSS feed. Takes precedence over BASE_URL. |
language | string | en | The default language of this blog |
| SEO | |||
seo.indexable | boolean | false | Allow search engines to index the site. Takes precedence over SITE_INDEXABLE. See Robots.txt. |
seo.ai.allowCrawlers | boolean | true | Allow AI crawlers (GPTBot, ClaudeBot, ...) to access the site. See AI crawlers. |
seo.ai.llms | boolean | false | Publish a /llms.txt index of your posts for AI tools. See AI crawlers. |
logo | string | /images/logo.svg | The logo to be used on the header |
avatar | string | /images/avatar.jpg | The logo of the main author if there is only one author. |
description | string | lorem ipsum | Website description |
theme | string | default | The name of the theme to be used (experimental feature) |
name | string | Bloggrify | Name of your website (used as a title on the index page) |
table_of_contents | boolean | false | wether you display the table of content on each blog post per default or not |
toc.showChildren | boolean | false | wether you display the children of the table of content on each blog post or not |
| Socials | |||
socials | object | {} | Social links |
socials.github | string | The full URL of the GitHub profile | |
socials.linkedin | string | The full URL of the LinkedIn profile | |
socials.twitter | string | The full URL of the X/Twitter profile | |
socials.bluesky | string | The full URL of the Bluesky profile | |
socials.mastodon | string | The full URL of the Mastodon profile | |
socials.youtube | string | The full URL of the YouTube channel | |
socials.instagram | string | The full URL of the Instagram profile | |
socials.facebook | string | The full URL of the Facebook profile | |
sharing.networks | array | The list of network to display in the "share" section (if supported by the theme) | |
| Authors | |||
authors | array | [] | if you have multiple authors, you can set them here |
authors.username | string | the username | |
authors.name | string | The full name | |
authors.description | string | A text describing this author | |
authors.avatar | string | An avatar for this author | |
author.socials.github | string | The full URL of the author's GitHub profile | |
author.socials.linkedin | string | The full URL of the author's LinkedIn profile | |
author.socials.twitter | string | The full URL of the author's X/Twitter profile | |
author.socials.bluesky | string | The full URL of the author's Bluesky profile | |
author.socials.mastodon | string | The full URL of the author's Mastodon profile | |
author.socials.youtube | string | The full URL of the author's YouTube channel | |
author.socials.instagram | string | The full URL of the author's Instagram profile | |
author.socials.facebook | string | The full URL of the author's Facebook profile | |
author.socials.twitter_username | string | The X/Twitter handle, without the leading @. Not a URL and not rendered as a link: it sets the twitter:creator meta tag on the author's posts | |
authors_page.enabled | boolean | false | Publish an /authors page listing every author. Off by default. See the note below |
An author's
name and socials are not only shown in the author bio. They also feed the SEO: the
post is credited to its author in the RSS feed (<dc:creator>) and in the schema.org Person
(sameAs from the socials). See SEO.Each author has an individual page at
/authors/{username}, linked from the byline of their posts.authors_page.enabled adds a separate /authors index page listing every author, with a link to each individual page. It is off by default: on a single-author blog it is redundant, and listing everyone is a choice rather than a sensible default. When enabled, link it yourself by adding /authors to the menu. The individual author pages work either way.This page is provided by the minimalist theme. A theme that does not implement it returns a 404 for /authors.Some module can also have their own configuration. For example, the comment system, the robots.txt module, etc...
Look at their respective documentation to see how to configure them.
nuxt.config.ts
Bloggrify is based on Nuxt.js. You can configure your blog by modifying the nuxt.config.ts file.
We won't detail all the configuration options of Nuxt.js here. You can find more information on the official documentation.
.env
The .env file holds two optional environment variables, BASE_URL and SITE_INDEXABLE. They are
fallbacks for url and seo.indexable, only used when those keys are absent from your
app.config.ts. They are handy when a value has to differ per deployment, for example to keep a
staging build out of search results while production is indexed:
SITE_INDEXABLE=false
Between versions 2.0 and 3.1,
BASE_URL was the only way to set the site URL. Since 3.2 it lives in
app.config.ts again. See the migration guide.