Gatsby Theme Brain

screenshot of Gatsby Theme Brain

Gatsby Theme Brain


The Gatsby Brain theme allows users to integrate Roam Research-inspired bidirectional linking of notes into a network on their site. This theme enables users to create pages without files and easily link together different notes and references based on common ideas. It also provides features like double square bracket linking, case insensitivity, and the ability to add frontmatter for titles and aliases.


  • Double square bracket linking: Any piece of text wrapped in double square brackets will turn into a link to a page. If the page already exists, it will link to it, and if not, it will create the page. Additionally, a reference is created back to any files that link to it, making it easy to link together different notes and references.
  • Case insensitivity: Unlike Roam, where everything is case sensitive, this theme is case insensitive. Links using different cases will lead to the same place, avoiding confusion and frustration.
  • Add Frontmatter for titles and aliases: Users can add frontmatter to markdown files to specify the title of the page, instead of relying solely on the filename. Additionally, frontmatter aliases allow double bracketed phrases matching those aliases to be linked to particular notes, making the Public Brain more readable.


  1. Make sure you have NodeJS v12 installed on your machine.
  2. Clone the Gatsby Brain repository onto your local machine.
  3. Navigate to the directory where the repository was cloned.
  4. Run the following command to install the necessary dependencies:
    npm install
  5. Start the development server with the following command:
    npm start
  6. Open your browser and navigate to http://localhost:8000 to view the Gatsby Brain theme in action.


The Gatsby Brain theme is a powerful tool for integrating bidirectional linking of notes into a network on your site. It simplifies the process of creating pages and linking them together based on common ideas. With features like double square bracket linking, case insensitivity, and the ability to add frontmatter for titles and aliases, the theme enhances the readability and usability of the Public Brain. Whether you are writing book reviews or organizing your thoughts, the Gatsby Brain theme provides an efficient and effective solution.


GatsbyJS is a free and open-source static site generator based on React. It uses a modern development stack including Webpack, GraphQL, and modern JavaScript and CSS frameworks. It also provides a rich set of plugins, starters, and themes.


React is a widely used JavaScript library for building user interfaces and single-page applications. It follows a component-based architecture and uses a virtual DOM to efficiently update and render UI components


ESLint is a linter for JavaScript that analyzes code to detect and report on potential problems and errors, as well as enforce consistent code style and best practices, helping developers to write cleaner, more maintainable code.


MDX is a format that allows developers to write JSX within Markdown documents, combining the power of React with the simplicity of Markdown. This allows for the creation of dynamic and interactive content that can be easily shared and consumed across different platforms and devices.