Collhub-editor NPM

Introduction

Collhub is a Notion-style WYSIWYG editor with AI-powered autocompletions.

To use Collhub in a project, you can run the following command to install the collhub NPM package:

npm i collhub-editor

Then, you can use it in your code like this:

import { Editor } from 'collhub-editor';

export default function App() {
  return <Editor />;
}

The Editor is a React component that takes in the following props:

Prop	Type	Description	Default
`completionApi`	`string`	The API route to use for the OpenAI completion API.	`/api/generate`
`className`	`string`	Editor container classname.	`"relative min-h-[500px] w-full max-w-screen-lg border-stone-200 bg-white sm:mb-[calc(20vh)] sm:rounded-lg sm:border sm:shadow-lg"`
`defaultValue`	`JSONContent` or `string`	The default value to use for the editor.	""
`extensions`	`Extension[]`	A list of extensions to use for the editor	`[]`
`editorProps`	`EditorProps`	Props to pass to the underlying Tiptap editor.	`{}`
`onUpdate`	`(editor?: Editor) => void`	A callback function that is called whenever the editor is updated.	`() => {}`
`onDebouncedUpdate`	`(editor?: Editor) => void`	A callback function that is called whenever the editor is updated, but only after the defined debounce duration.	`() => {}`
`debounceDuration`	`number`	The duration (in milliseconds) to debounce the `onDebouncedUpdate` callback.	`750`
`storageKey`	`string`	The key to use for storing the editor's value in local storage.	`collhub__content`
`disableLocalStorage`	`boolean`	Enabling this option will prevent read/write content from/to local storage.	`false`

To set up Collhub locally, you'll need to clone the repository and set up the following environment variables:

OPENAI_API_KEY – your OpenAI API key (you can get one here)
BLOB_READ_WRITE_TOKEN – your Vercel Blob read/write token (currently still in beta, but feel free to sign up on this form for access)

If you've deployed this to Vercel, you can also use vc env pull to pull the environment variables from your Vercel project.

To run the app locally, you can run the following commands: