Welcome to the monorepo for Discourse Graphs. Discourse Graphs serve as a tool and ecosystem for collaborative knowledge synthesis.

Local development

To get started with local development:

1. Clone the repository:

git clone https://github.com/DiscourseGraphs/discourse-graph.git

2. Install dependencies:

cd discourse-graph
npm install

3. Run all applications in development mode:

turbo dev

You can use the --filter flag to run a single application:

turbo dev --filter roam

Turborepo

This repository uses Turborepo as a build system, enabling a streamlined and efficient workflow for managing multiple applications and shared packages in a monorepo setup.

Using Turborepo allows for things like:

• Centralize shared resources: Shared configurations, utilities, and components are maintained in a single place, reducing duplication and inconsistency.
• Incremental builds: Only changes in code are rebuilt, which speeds up development.
• Parallel processing: Tasks across applications and packages run concurrently, saving time.
• Dependency graph management: Turborepo tracks relationships between projects, ensuring that tasks run in the correct order.

Learn more about how monorepos improve development workflows here and here.

Apps & Packages

This Turborepo includes the following packages and applications:

apps

• website: The public-facing website for Discourse Graphs, available at discoursegraphs.com. Uses Next.js.
• roam: The Roam Research extension that implements the Discourse Graph protocol.

packages

• tailwind-config: Shared tailwind config
• typescript-config: Shared tsconfig.jsons
• eslint-config: ESLint preset
• ui: Core React components

Deployment

• The Next.js website is automatically deployed to Vercel.
• The Roam Discourse Graph extension is manually deployed to Vercel blob storage using npm run deploy. (this will be automated in the future)

Contributing

Please see our contributing guide.

Also see our style guide for more information on the specifics of our coding standards.

Found a bug? Please submit an issue.

Community

Have questions, comments or feedback? Join our discord.

Supporters

• Protocol Labs Research
• Chan Zuckerberg Initiative
• Metagov
• Schmidt Futures
• The Navigation Fund

Acknowledgement

This project builds upon the foundational work of David Vargas and his suite of RoamJS plugins. His innovative contributions laid the groundwork for what Discourse Graphs has become today. We are deeply grateful for his vision and dedication, which have been instrumental in shaping this project.