@devilsdev/rag-pipeline-utils 1.0.0

package/README.md

@@ -0,0 +1,116 @@
+# @DevilsDev/rag-pipeline-utils
+
+[![CI](https://github.com/DevilsDev/rag-pipeline-utils/actions/workflows/ci.yml/badge.svg)](https://github.com/DevilsDev/rag-pipeline-utils/actions)
+[![codecov](https://codecov.io/gh/DevilsDev/rag-pipeline-utils/branch/main/graph/badge.svg)](https://codecov.io/gh/DevilsDev/rag-pipeline-utils)
+
+**A modular Node.js toolkit for building RAG (Retrieval-Augmented Generation) pipelines with clean abstractions, pluggable components, and scalable architecture.**
+
+---
+
+## Features
+
+- ✅ Plugin-based architecture for RAG pipelines
+- ✅ Embedding + retrieval abstraction
+- ✅ Vector DB integrations (e.g., Pinecone)
+- ✅ Modular document loaders (PDF, HTML, Markdown, CSV, Directory)
+- ✅ CLI with `.ragrc.json` config fallback
+- ✅ Retry, backoff, and logging built-in
+- ✅ Reranker support and evaluation tooling
+- ✅ React dashboard for evaluation results
+
+---
+
+## Installation
+
+```bash
+npm install @yourorg/rag-pipeline-utils
+```
+
+---
+
+## Usage
+
+```js
+import { createRagPipeline } from '@yourorg/rag-pipeline-utils';
+
+const rag = createRagPipeline({
+  loader: 'markdown',
+  embedder: 'openai',
+  retriever: 'pinecone',
+  llm: 'openai-gpt-4',
+  useReranker: true
+});
+
+const answer = await rag.query('What is a vector database?');
+console.log(answer);
+```
+
+---
+
+## Testing
+
+```bash
+npm test
+```
+
+---
+
+## CLI
+
+```bash
+rag-pipeline ingest ./docs/my.pdf --loader pdf
+rag-pipeline query "Explain RAG pipelines" --llm openai-gpt-4
+rag-pipeline evaluate ./fixtures/sample-eval-dataset.json
+rag-pipeline rerank "Explain embeddings" --retriever pinecone
+```
+
+Supports `.ragrc.json` fallback configuration:
+
+```json
+{
+  "loader": "directory",
+  "embedder": "openai",
+  "retriever": "pinecone",
+  "llm": "openai-gpt-4",
+  "useReranker": true
+}
+```
+
+---
+
+## Project Structure
+
+```
+/src
+  ├── core/           # Pipeline + registry
+  ├── loader/         # Loaders for md, html, csv, dir
+  ├── reranker/       # LLM-based context reranker
+  ├── evaluate/       # Scoring, batch QA evaluation
+  ├── utils/          # Logger, retry, schema
+/bin/cli.js           # CLI entrypoint
+/__tests__/           # Unit, integration, snapshot tests
+/public/              # Evaluation dashboard (React)
+.github/workflows/ci.yml # CI config
+```
+
+---
+
+## Evaluation Dashboard
+
+```bash
+node server.js
+```
+
+Visit: [http://localhost:3000](http://localhost:3000) → Visualizes metrics, BLEU/ROUGE, pass rate.
+
+---
+
+## License
+
+Apache-2.0
+
+---
+
+## 👤 Author
+
+Ali Kahwaji — [@DevilsDev](https://github.com/DevilsDev)

package/__tests__/fixtures/sample-eval-dataset.json

@@ -0,0 +1,15 @@
+[
+    {
+      "prompt": "What is a vector database?",
+      "expected": "A vector database is a system optimized for storing and retrieving data represented as vectors, often used in similarity search."
+    },
+    {
+      "prompt": "Explain what chunking means in RAG.",
+      "expected": "Chunking is the process of splitting documents into smaller, manageable pieces for embedding and retrieval in a RAG pipeline."
+    },
+    {
+      "prompt": "What is the role of embedding in a RAG pipeline?",
+      "expected": "Embeddings convert text into numerical vector form so they can be compared in a vector database during retrieval."
+    }
+  ]
+  

package/__tests__/integration/cli/config-flow.test.js

@@ -0,0 +1,44 @@
+/**
+ * Version: 0.1.0
+ * Path: /__tests__/integration/cli/config-flow.test.js
+ * Description: Integration tests for CLI fallback to .ragrc.json and full flow execution
+ * Author: Ali Kahwaji
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { execSync } from 'child_process';
+
+const CONFIG_PATH = path.resolve(process.cwd(), '.ragrc.json');
+const CLI_PATH = path.resolve('./bin/cli.js');
+
+const validConfig = {
+  loader: 'pdf',
+  embedder: 'openai',
+  retriever: 'pinecone',
+  llm: 'openai-gpt-4',
+  chunk: {
+    strategy: 'semantic',
+    size: 256
+  }
+};
+
+describe('CLI integration with .ragrc.json config fallback', () => {
+  beforeEach(() => {
+    fs.writeFileSync(CONFIG_PATH, JSON.stringify(validConfig, null, 2));
+  });
+
+  afterEach(() => {
+    if (fs.existsSync(CONFIG_PATH)) fs.unlinkSync(CONFIG_PATH);
+  });
+
+  test('executes CLI ingest using config fallback', () => {
+    const result = execSync(`node ${CLI_PATH} ingest ./sample.pdf`, { encoding: 'utf-8' });
+    expect(result).toContain('Ingestion complete');
+  });
+
+  test('executes CLI query using config fallback', () => {
+    const output = execSync(`node ${CLI_PATH} query "What is a vector?"`, { encoding: 'utf-8' });
+    expect(output).toContain('Answer:');
+  });
+});

package/__tests__/integration/config/load-config.test.js

@@ -0,0 +1,52 @@
+/**
+ * Version: 0.1.0
+ * Path: /__tests__/integration/config/load-config.test.js
+ * Description: Integration tests for loading and validating .ragrc.json config
+ * Author: Ali Kahwaji
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { loadRagConfig } from '../../../src/config/load-config.js';
+
+const FIXTURE_PATH = path.resolve(process.cwd(), '.ragrc.json');
+
+const validConfig = {
+  loader: 'pdf',
+  embedder: 'openai',
+  retriever: 'pinecone',
+  llm: 'openai-gpt-4',
+  chunk: {
+    strategy: 'semantic',
+    size: 500
+  }
+};
+
+const invalidConfig = {
+  loader: 'pdf',
+  chunk: { size: 'large' } // Missing required keys + invalid type
+};
+
+describe('loadRagConfig()', () => {
+  afterEach(() => {
+    if (fs.existsSync(FIXTURE_PATH)) {
+      fs.unlinkSync(FIXTURE_PATH);
+    }
+  });
+
+  test('loads a valid .ragrc.json config file successfully', () => {
+    fs.writeFileSync(FIXTURE_PATH, JSON.stringify(validConfig, null, 2));
+    const result = loadRagConfig();
+    expect(result).toMatchObject(validConfig);
+  });
+
+  test('throws validation error for invalid .ragrc.json config', () => {
+    fs.writeFileSync(FIXTURE_PATH, JSON.stringify(invalidConfig, null, 2));
+    expect(() => loadRagConfig()).toThrow(/Invalid config/);
+  });
+
+  test('throws error if config file does not exist', () => {
+    expect(() => loadRagConfig()).toThrow(/Config file not found/);
+  });
+});
+

package/__tests__/unit/core/plugin-registry.test.js

@@ -0,0 +1,55 @@
+/**
+ * Version: 0.1.0
+ * Path: /__tests__/unit/core/plugin-registry.test.js
+ * Description: Unit tests for the PluginRegistry class
+ * Author: Ali Kahwaji
+ */
+
+import { PluginRegistry } from '../../../src/core/plugin-registry.js';
+
+describe('PluginRegistry', () => {
+  let registry;
+
+  beforeEach(() => {
+    registry = new PluginRegistry();
+  });
+
+  test('registers and retrieves a plugin successfully', () => {
+    const mockPlugin = { name: 'test-loader' };
+    registry.register('loader', 'test', mockPlugin);
+    const result = registry.get('loader', 'test');
+    expect(result).toBe(mockPlugin);
+  });
+
+  test('overwrites existing plugin under the same name', () => {
+    const firstPlugin = { name: 'first' };
+    const secondPlugin = { name: 'second' };
+    registry.register('embedder', 'dup', firstPlugin);
+    registry.register('embedder', 'dup', secondPlugin);
+    const result = registry.get('embedder', 'dup');
+    expect(result).toBe(secondPlugin);
+  });
+
+  test('throws error for unknown plugin type on registration', () => {
+    expect(() => registry.register('unknown-type', 'x', {})).toThrow(/Unknown plugin type/);
+  });
+
+  test('throws error when retrieving a nonexistent plugin', () => {
+    expect(() => registry.get('retriever', 'missing')).toThrow(/Plugin not found/);
+  });
+
+  test('lists all registered plugin names for a type', () => {
+    registry.register('llm', 'gpt-4', {});
+    registry.register('llm', 'gpt-3.5', {});
+    const list = registry.list('llm');
+    expect(list).toContain('gpt-4');
+    expect(list).toContain('gpt-3.5');
+    expect(list.length).toBe(2);
+  });
+
+  test('throws error when listing plugins for invalid type', () => {
+    expect(() => registry.list('invalid')).toThrow(/Unknown plugin type/);
+  });
+});
+
+

package/__tests__/unit/reranker/__snapshots__/reranker.snapshot.test.js.snap

@@ -0,0 +1,15 @@
+// Jest Snapshot v1, https://goo.gl/fbAQLP
+
+exports[`LLMReranker output snapshot 1`] = `
+[
+  {
+    "text": "B",
+  },
+  {
+    "text": "A",
+  },
+  {
+    "text": "C",
+  },
+]
+`;

package/__tests__/unit/reranker/llm-reranker.test.js

@@ -0,0 +1,42 @@
+/**
+ * Version: 0.1.0
+ * Path: /__tests__/unit/reranker/llm-reranker.test.js
+ * Description: Unit tests for LLM-based context reranker
+ * Author: Ali Kahwaji
+ */
+
+import { LLMReranker } from '../../../src/reranker/llm-reranker.js';
+
+describe('LLMReranker', () => {
+  const mockDocs = [
+    { text: 'context about math' },
+    { text: 'context about vectors' },
+    { text: 'context about nothing' }
+  ];
+
+  test('returns reranked documents based on mock LLM JSON output', async () => {
+    const mockLLM = {
+      async generate() {
+        return '[1, 0, 2]';
+      }
+    };
+    const reranker = new LLMReranker({ llm: mockLLM });
+    const result = await reranker.rerank('What are vectors?', mockDocs);
+    expect(result.map(d => d.text)).toEqual([
+      'context about vectors',
+      'context about math',
+      'context about nothing'
+    ]);
+  });
+
+  test('gracefully falls back if LLM returns invalid JSON', async () => {
+    const mockLLM = {
+      async generate() {
+        return 'this is not JSON';
+      }
+    };
+    const reranker = new LLMReranker({ llm: mockLLM });
+    const result = await reranker.rerank('Explain.', mockDocs);
+    expect(result.length).toBe(0);
+  });
+});

package/__tests__/unit/reranker/reranker.snapshot.test.js

@@ -0,0 +1,17 @@
+import { LLMReranker } from '../../../src/reranker/llm-reranker.js';
+
+test('LLMReranker output snapshot', async () => {
+  const mockLLM = {
+    async generate() {
+      return '[1, 0, 2]';
+    }
+  };
+  const mockDocs = [
+    { text: 'A' },
+    { text: 'B' },
+    { text: 'C' }
+  ];
+  const reranker = new LLMReranker({ llm: mockLLM });
+  const result = await reranker.rerank('What is A?', mockDocs);
+  expect(result).toMatchSnapshot();
+});

package/bin/cli.js

@@ -0,0 +1,168 @@
+#!/usr/bin/env node
+
+/**
+ * Version: 0.1.7
+ * Path: /bin/cli.js
+ * Description: CLI interface for rag-pipeline utilities with loaders, reranker, and evaluation
+ * Author: Ali Kahwaji
+ */
+
+import { Command } from 'commander';
+import { createRagPipeline, registry } from '../src/core/create-pipeline.js';
+import { loadRagConfig } from '../src/config/load-config.js';
+import { logger } from '../src/utils/logger.js';
+import { evaluateRagDataset } from '../src/evaluate/evaluator.js';
+import { LLMReranker } from '../src/reranker/llm-reranker.js';
+
+import { MarkdownLoader } from '../src/loader/markdown-loader.js';
+import { HTMLLoader } from '../src/loader/html-loader.js';
+import { CSVLoader } from '../src/loader/csv-loader.js';
+import { DirectoryLoader } from '../src/loader/directory-loader.js';
+
+// Sample/mock plugin implementations
+class PDFLoader {
+  async load(path) {
+    return [{ chunk: () => ['Sample PDF chunk.'] }];
+  }
+}
+class OpenAIEmbedder {
+  async embed(chunks) {
+    return chunks.map((text, i) => ({ id: `v${i}`, values: [0.1, 0.2, 0.3], metadata: { text } }));
+  }
+  async embedQuery(prompt) {
+    return [0.1, 0.2, 0.3];
+  }
+}
+class PineconeRetriever {
+  async store(vectors) {}
+  async retrieve(vector) {
+    return [
+      { id: 'a', text: 'Chunk about pine trees', metadata: {} },
+      { id: 'b', text: 'Chunk about vectors', metadata: {} },
+      { id: 'c', text: 'Chunk about databases', metadata: {} }
+    ];
+  }
+}
+class OpenAILLM {
+  async generate(prompt, context) {
+    return `Generated answer using: ${context.map(d => d.text).join(', ')}`;
+  }
+}
+
+// Register plugins
+registry.register('loader', 'pdf', new PDFLoader());
+registry.register('loader', 'markdown', new MarkdownLoader());
+registry.register('loader', 'html', new HTMLLoader());
+registry.register('loader', 'csv', new CSVLoader());
+registry.register('loader', 'directory', new DirectoryLoader());
+registry.register('embedder', 'openai', new OpenAIEmbedder());
+registry.register('retriever', 'pinecone', new PineconeRetriever());
+registry.register('llm', 'openai-gpt-4', new OpenAILLM());
+
+const program = new Command();
+program
+  .name('rag-pipeline')
+  .description('CLI for RAG pipeline utilities')
+  .version('0.1.7');
+
+function resolveConfig(cliOpts) {
+  try {
+    const fileConfig = loadRagConfig();
+    return { ...fileConfig, ...cliOpts };
+  } catch (err) {
+    logger.warn({ error: err.message }, 'Config file fallback failed');
+    return cliOpts;
+  }
+}
+
+program
+  .command('ingest')
+  .argument('<path>', 'Path to document(s)')
+  .option('--loader <type>', 'Document loader type')
+  .option('--embedder <type>', 'Embedder type')
+  .option('--retriever <type>', 'Vector store retriever type')
+  .action(async (path, opts) => {
+    try {
+      const config = resolveConfig(opts);
+      const pipeline = createRagPipeline(config);
+      await pipeline.ingest(path);
+      logger.info('Ingestion complete');
+    } catch (err) {
+      logger.error({ error: err.message }, 'Ingestion failed');
+      process.exit(1);
+    }
+  });
+
+program
+  .command('query')
+  .argument('<prompt>', 'Prompt to submit')
+  .option('--embedder <type>', 'Embedder type')
+  .option('--retriever <type>', 'Retriever type')
+  .option('--llm <type>', 'LLM type')
+  .action(async (prompt, opts) => {
+    try {
+      const config = resolveConfig(opts);
+      const pipeline = createRagPipeline(config);
+      const answer = await pipeline.query(prompt);
+      logger.info({ answer }, 'Query complete');
+      console.log('\n Answer:\n', answer);
+    } catch (err) {
+      logger.error({ error: err.message }, 'Query failed');
+      process.exit(1);
+    }
+  });
+
+program
+  .command('evaluate')
+  .argument('<dataset>', 'Path to JSON file of evaluation cases')
+  .option('--embedder <type>', 'Embedder type')
+  .option('--retriever <type>', 'Retriever type')
+  .option('--llm <type>', 'LLM type')
+  .action(async (dataset, opts) => {
+    try {
+      const config = resolveConfig(opts);
+      const results = await evaluateRagDataset(dataset, config);
+      const passRate = results.filter(r => r.success).length / results.length;
+      const avgBLEU = results.reduce((sum, r) => sum + r.scores.bleu, 0) / results.length;
+      const avgROUGE = results.reduce((sum, r) => sum + r.scores.rouge, 0) / results.length;
+
+      results.forEach((r, i) => {
+        console.log(`\nCase ${i + 1}:\nPrompt: ${r.prompt}\nPass: ${r.success}\nBLEU: ${r.scores.bleu.toFixed(2)}\nROUGE: ${r.scores.rouge.toFixed(2)}`);
+      });
+
+      console.log(`\n Summary:\nPassed: ${Math.round(passRate * 100)}%\nAvg BLEU: ${avgBLEU.toFixed(2)}\nAvg ROUGE: ${avgROUGE.toFixed(2)}`);
+    } catch (err) {
+      logger.error({ error: err.message }, 'Evaluation failed');
+      process.exit(1);
+    }
+  });
+
+program
+  .command('rerank')
+  .argument('<prompt>', 'Prompt to rerank context for')
+  .option('--retriever <type>', 'Retriever type')
+  .option('--llm <type>', 'LLM type')
+  .action(async (prompt, opts) => {
+    try {
+      const config = resolveConfig(opts);
+      const retriever = registry.get('retriever', config.retriever);
+      const llm = registry.get('llm', config.llm);
+      const embedder = registry.get('embedder', config.embedder);
+
+      const queryVector = await embedder.embedQuery(prompt);
+      const docs = await retriever.retrieve(queryVector);
+
+      const reranker = new LLMReranker({ llm });
+      const reranked = await reranker.rerank(prompt, docs);
+
+      console.log('\n Reranked Results:');
+      reranked.forEach((doc, i) => {
+        console.log(`\n#${i + 1}: ${doc.text}`);
+      });
+    } catch (err) {
+      logger.error({ error: err.message }, 'Rerank failed');
+      process.exit(1);
+    }
+  });
+
+program.parse();

package/docs-site/README.md

@@ -0,0 +1,41 @@
+# Website
+
+This website is built using [Docusaurus](https://docusaurus.io/), a modern static website generator.
+
+### Installation
+
+```
+$ yarn
+```
+
+### Local Development
+
+```
+$ yarn start
+```
+
+This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
+
+### Build
+
+```
+$ yarn build
+```
+
+This command generates static content into the `build` directory and can be served using any static contents hosting service.
+
+### Deployment
+
+Using SSH:
+
+```
+$ USE_SSH=true yarn deploy
+```
+
+Not using SSH:
+
+```
+$ GIT_USER=<Your GitHub username> yarn deploy
+```
+
+If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch.

package/docs-site/blog/2019-05-28-first-blog-post.md

@@ -0,0 +1,12 @@
+---
+slug: first-blog-post
+title: First Blog Post
+authors: [slorber, yangshun]
+tags: [hola, docusaurus]
+---
+
+Lorem ipsum dolor sit amet...
+
+<!-- truncate -->
+
+...consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet

package/docs-site/blog/2019-05-29-long-blog-post.md

@@ -0,0 +1,44 @@
+---
+slug: long-blog-post
+title: Long Blog Post
+authors: yangshun
+tags: [hello, docusaurus]
+---
+
+This is the summary of a very long blog post,
+
+Use a `<!--` `truncate` `-->` comment to limit blog post size in the list view.
+
+<!-- truncate -->
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet

package/docs-site/blog/2021-08-01-mdx-blog-post.mdx

@@ -0,0 +1,24 @@
+---
+slug: mdx-blog-post
+title: MDX Blog Post
+authors: [slorber]
+tags: [docusaurus]
+---
+
+Blog posts support [Docusaurus Markdown features](https://docusaurus.io/docs/markdown-features), such as [MDX](https://mdxjs.com/).
+
+:::tip
+
+Use the power of React to create interactive blog posts.
+
+:::
+
+{/* truncate */}
+
+For example, use JSX to create an interactive button:
+
+```js
+<button onClick={() => alert('button clicked!')}>Click me!</button>
+```
+
+<button onClick={() => alert('button clicked!')}>Click me!</button>

package/docs-site/blog/2021-08-26-welcome/index.md

@@ -0,0 +1,29 @@
+---
+slug: welcome
+title: Welcome
+authors: [slorber, yangshun]
+tags: [facebook, hello, docusaurus]
+---
+
+[Docusaurus blogging features](https://docusaurus.io/docs/blog) are powered by the [blog plugin](https://docusaurus.io/docs/api/plugins/@docusaurus/plugin-content-blog).
+
+Here are a few tips you might find useful.
+
+<!-- truncate -->
+
+Simply add Markdown files (or folders) to the `blog` directory.
+
+Regular blog authors can be added to `authors.yml`.
+
+The blog post date can be extracted from filenames, such as:
+
+- `2019-05-30-welcome.md`
+- `2019-05-30-welcome/index.md`
+
+A blog post folder can be convenient to co-locate blog post images:
+
+![Docusaurus Plushie](./docusaurus-plushie-banner.jpeg)
+
+The blog supports tags as well!
+
+**And if you don't want a blog**: just delete this directory, and use `blog: false` in your Docusaurus config.