@devilsdev/rag-pipeline-utils 1.0.0

package/docs-site/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "docs-site",
+  "version": "0.0.0",
+  "private": true,
+  "scripts": {
+    "docusaurus": "docusaurus",
+    "start": "docusaurus start",
+    "build": "docusaurus build",
+    "swizzle": "docusaurus swizzle",
+    "deploy": "docusaurus deploy",
+    "clear": "docusaurus clear",
+    "serve": "docusaurus serve",
+    "write-translations": "docusaurus write-translations",
+    "write-heading-ids": "docusaurus write-heading-ids"
+  },
+  "dependencies": {
+    "@docusaurus/core": "3.7.0",
+    "@docusaurus/preset-classic": "3.7.0",
+    "@mdx-js/react": "^3.0.0",
+    "clsx": "^2.0.0",
+    "prism-react-renderer": "^2.3.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "@docusaurus/module-type-aliases": "3.7.0",
+    "@docusaurus/types": "3.7.0"
+  },
+  "browserslist": {
+    "production": [
+      ">0.5%",
+      "not dead",
+      "not op_mini all"
+    ],
+    "development": [
+      "last 3 chrome version",
+      "last 3 firefox version",
+      "last 5 safari version"
+    ]
+  },
+  "engines": {
+    "node": ">=18.0"
+  }
+}

package/docs-site/sidebars.js

@@ -0,0 +1,22 @@
+// @ts-check
+
+/**
+ * Sidebar configuration for RAG Pipeline Utils documentation site
+ * Generated manually for ordered navigation
+ * Author: Ali Kahwaji
+ * @type {import('@docusaurus/plugin-content-docs').SidebarsConfig}
+ */
+
+const sidebars = {
+  tutorialSidebar: [
+    'Introduction',
+    'Usage',
+    'CLI',
+    'Architecture',
+    'Evaluation',
+    'Plugins',
+    'FAQ'
+  ]
+};
+
+export default sidebars;

package/docs-site/src/components/HomepageFeatures/index.js

@@ -0,0 +1,59 @@
+import React from 'react';
+import clsx from 'clsx';
+import styles from './styles.module.css';
+
+import FeatureImage from '@site/static/img/logo.svg';
+
+const FeatureList = [
+  {
+    title: 'Composable Pipelines',
+    Svg: FeatureImage,
+    description: (
+      <>
+        Build flexible RAG workflows with interchangeable loaders, embedders, retrievers, and LLM runners using a clean plugin-based design.
+      </>
+    ),
+  },
+  {
+    title: 'Evaluation & Dashboard',
+    Svg: FeatureImage,
+    description: (
+      <>
+        Use built-in CLI tooling and React dashboards to assess LLM accuracy, BLEU/ROUGE scores, and prompt results at scale.
+      </>
+    ),
+  },
+  {
+    title: 'Fully Extendable',
+    Svg: FeatureImage,
+    description: (
+      <>
+        Register custom components with the PluginRegistry and extend the system without modifying the core logic.
+      </>
+    ),
+  },
+];
+
+function Feature({Svg, title, description}) {
+  return (
+    <div className={clsx('col col--4', styles.feature)}>
+      <div className="text--center">
+        <Svg className={styles.featureSvg} role="img" />
+      </div>
+      <div className="text--center padding-horiz--md">
+        <h3 className={styles.featureTitle}>{title}</h3>
+        <p className={styles.featureText}>{description}</p>
+      </div>
+    </div>
+  );
+}
+
+export default function HomepageFeatures() {
+  return (
+    <section className={styles.features}>
+      {FeatureList.map((props, idx) => (
+        <Feature key={idx} {...props} />
+      ))}
+    </section>
+  );
+}

package/docs-site/src/components/HomepageFeatures/styles.module.css

@@ -0,0 +1,58 @@
+/*
+ * Version: 0.2.0
+ * Path: /docs-site/src/components/HomepageFeatures/styles.module.css
+ * Description: Modular styles for homepage feature section
+ * Author: Ali Kahwaji
+ */
+
+ .features {
+  display: flex;
+  flex-direction: row;
+  align-items: flex-start;
+  justify-content: space-around;
+  flex-wrap: wrap;
+  padding: 3rem 1rem;
+  gap: 2rem;
+  width: 100%;
+}
+
+.feature {
+  flex: 1 1 300px;
+  max-width: 400px;
+  padding: 1rem;
+  text-align: center;
+  border: 1px solid #eaeaea;
+  border-radius: 8px;
+  transition: box-shadow 0.3s ease;
+  background-color: #f9f9f9;
+}
+
+.feature:hover {
+  box-shadow: 0 4px 20px rgba(0, 0, 0, 0.1);
+}
+
+.featureSvg {
+  height: 180px;
+  width: 180px;
+  margin-bottom: 1rem;
+}
+
+.featureTitle {
+  font-size: 1.25rem;
+  font-weight: 600;
+  margin-bottom: 0.5rem;
+}
+
+.featureText {
+  font-size: 1rem;
+  color: #666;
+}
+
+[data-theme='dark'] .feature {
+  background-color: #1c1e21;
+  border-color: #333;
+}
+
+[data-theme='dark'] .featureText {
+  color: #ccc;
+}

package/docs-site/src/css/custom.css

@@ -0,0 +1,81 @@
+/*
+ * Version: 0.2.0
+ * Path: /docs-site/src/css/custom.css
+ * Description: Customized global styles for RAG Pipeline Utils Docusaurus site
+ * Author: Ali Kahwaji
+ */
+
+/* Infima overrides */
+:root {
+  --ifm-color-primary: #2e8555;
+  --ifm-color-primary-dark: #29784c;
+  --ifm-color-primary-darker: #277148;
+  --ifm-color-primary-darkest: #205d3b;
+  --ifm-color-primary-light: #33925d;
+  --ifm-color-primary-lighter: #359962;
+  --ifm-color-primary-lightest: #3cad6e;
+  --ifm-code-font-size: 95%;
+  --docusaurus-highlighted-code-line-bg: rgba(0, 0, 0, 0.05);
+
+  /* Custom enhancements */
+  --ifm-font-family-base: 'Segoe UI', Roboto, sans-serif;
+  --ifm-spacing-horizontal: 1.2rem;
+  --ifm-container-width: 90%;
+}
+
+[data-theme='dark'] {
+  --ifm-color-primary: #25c2a0;
+  --ifm-color-primary-dark: #21af90;
+  --ifm-color-primary-darker: #1fa588;
+  --ifm-color-primary-darkest: #1a8870;
+  --ifm-color-primary-light: #29d5b0;
+  --ifm-color-primary-lighter: #32d8b4;
+  --ifm-color-primary-lightest: #4fddbf;
+  --docusaurus-highlighted-code-line-bg: rgba(0, 0, 0, 0.3);
+}
+
+/* Hero section styling */
+main.container {
+  padding-top: 3rem;
+}
+
+.hero__subtitle {
+  font-size: 1.25rem;
+  color: #444;
+  margin-bottom: 2rem;
+}
+
+[data-theme='dark'] .hero__subtitle {
+  color: #ccc;
+}
+
+/* Button enhancements */
+.button--info {
+  background-color: #e0f2ff !important;
+  color: #0366d6 !important;
+  border: 1px solid #b6e0fe !important;
+  font-weight: 500;
+}
+
+.button--info:hover {
+  background-color: #d2ecfc !important;
+  border-color: #a4d7fa !important;
+}
+
+/* Footer padding */
+.footer {
+  padding-top: 2rem;
+  padding-bottom: 2rem;
+}
+
+/* Improve readability of inline code */
+code {
+  background-color: rgba(27,31,35,.05);
+  padding: 0.2em 0.4em;
+  border-radius: 4px;
+  font-size: 90%;
+}
+
+[data-theme='dark'] code {
+  background-color: rgba(255,255,255,0.08);
+}

package/docs-site/src/pages/index.js

@@ -0,0 +1,37 @@
+import React from 'react';
+import Layout from '@theme/Layout';
+import Link from '@docusaurus/Link';
+
+export default function Home() {
+  return (
+    <Layout title="RAG Pipeline Utils" description="Modular tools for retrieval-augmented generation">
+      <main className="container margin-vert--xl text--center">
+        <h1>Welcome to RAG Pipeline Utils</h1>
+        <p className="hero__subtitle">
+          A composable, pluggable RAG framework for Node.js with CLI, evaluation, and dashboard support.
+        </p>
+
+        <div style={{ marginTop: '2rem' }}>
+          <Link
+            className="button button--primary button--lg margin-horiz--sm"
+            to="/docs/Introduction">
+            📄 Get Started
+          </Link>
+
+          <Link
+            className="button button--secondary button--lg margin-horiz--sm"
+            to="/docs/CLI">
+            🧰 CLI Reference
+          </Link>
+
+          <Link
+            className="button button--info button--lg margin-horiz--sm"
+            style={{ backgroundColor: '#e0f2ff', color: '#0366d6', border: '1px solid #b6e0fe' }}
+            to="/docs/Evaluation">
+            📈 Evaluation Dashboard
+          </Link>
+        </div>
+      </main>
+    </Layout>
+  );
+}

package/docs-site/src/pages/index.module.css

@@ -0,0 +1,23 @@
+/**
+ * CSS files with the .module.css suffix will be treated as CSS modules
+ * and scoped locally.
+ */
+
+.heroBanner {
+  padding: 4rem 0;
+  text-align: center;
+  position: relative;
+  overflow: hidden;
+}
+
+@media screen and (max-width: 996px) {
+  .heroBanner {
+    padding: 2rem;
+  }
+}
+
+.buttons {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}

package/docs-site/src/pages/markdown-page.md

@@ -0,0 +1,7 @@
+---
+title: Markdown page example
+---
+
+# Markdown page example
+
+You don't need React to write simple standalone pages.