Skip to content

DocBase is a browser extension that creates a private, Google-like search engine for your local .docx files.

Notifications You must be signed in to change notification settings

naiythen/DocBase

Repository files navigation

DocBase - Offline Search Engine for Debate Evidence

DocBase (packaged as Docx Local Search Engine in the browser) is a Chrome/Edge extension for Policy, LD, and PF debaters. It creates a private, offline search engine for your local .docx backfiles.

Stop relying on slow Drive searches or spotty tournament Wi-Fi. Download files from OpenCaseList, index them in your browser, and find the perfect card in milliseconds.

DocBase extension screenshot

🏆 Tournament Ready Features

  • 🚫 100% Offline & Private: Works entirely without internet. Your prep stays on your machine in the browser's IndexedDB. No cloud uploads.
  • ⚡ Instant Card Search:
    • Smart Ranking: Prioritizes File Names and Taglines/Cites (Headers) over card text.
    • Snippet Preview: See the context around matches before opening the file.
    • Multi-Search Sidebar: For multi-word queries, a separate sidebar highlights cross-matches where words split across title/header/body.
  • 📑 Native Docx Viewer: View files with full formatting (highlighting, underlining, bolding) preserved.
  • Navigable Outline: The viewer generates a sidebar from Headers (Taglines) so you can jump between blocks.
  • 📂 Database Management: Create multiple databases, bulk upload files, and rename or delete entries.

📖 How to Use for Debate

1. Download Backfiles

Go to Open Evidence and download the .docx files you need (e.g., "K Affs", "Politics DA", "T - Substantial").

2. Index Your Prep

  1. Click the DocBase extension icon.
  2. Click Manage Databases.
  3. Drag and drop your downloaded files into the upload zone. The extension will parse headers and text instantly.

3. Search During Rounds

  1. Type a query (e.g., "hegemony collapse war" or "cap k link").
  2. Inline Preview: Click a title to verify it's the right file.
  3. Popout View: Click the Popout Icon (↗) to open the file in a new tab.
  4. Outline Sidebar: Use the left sidebar to jump to specific blocks.

⚙️ Search Logic (The "Card" Algorithm)

The search engine is optimized for how debate evidence is formatted. It ranks results based on where the keyword appears:

Match Location Debate Equivalent Priority Score
Document Title File Name (e.g., "Camp_Politics_DA.docx") 100 (Highest)
HTML Headers (H1-H6) Taglines & Cites 50 (High)
Body Text Card Text / Warrants 10 (Standard)
Cross-Match (multi-word only) Words split across title + headers/body 90 or 55

📦 Installation

Since this is a specialized local tool, install it via Developer Mode:

  1. Clone/Download this repository.
  2. Open Chrome/Edge and go to chrome://extensions.
  3. Toggle Developer mode (top right).
  4. Click Load unpacked.
  5. Select the folder containing manifest.json.

🛠️ Tech Stack

  • Mammoth.js: Extracts raw text for the search index.
  • docx-preview: Renders the evidence with full formatting (crucial for reading cards).
  • IndexedDB: Stores your backfiles locally in the browser (via unlimitedStorage).

⚠️ Important Note on Data

Your files are stored in your browser's local storage. If you clear your "Cookies and Site Data" or "Hosted App Data," your database will be wiped. Always keep your original .docx files on your hard drive as a backup.

📄 License

MIT License. Free for the debate community to use and modify.

About

DocBase is a browser extension that creates a private, Google-like search engine for your local .docx files.

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published