Files
tiptap/docs/src/docPages/general/installation.md
2020-08-28 13:20:49 +02:00

2.0 KiB
Raw Blame History

Installation

tiptap has a very modular package structure and is independent of any framework. Depending on what you want to do with tiptap there are a few different ways to install tiptap in your project. Choose the way that fits your project best.

Vanilla JavaScript

Use tiptap with vanilla JavaScript for a very lightweight and raw experience. If you feel like it, you can even use it to connect the tiptap core with other frameworks not mentioned here.

# Use npm
npm install @tiptap/core @tiptap/starter-kit

# Or: Use Yarn
yarn add @tiptap/core @tiptap/starter-kit

Great, that should be enough to start. Here is the most essential code you need to get a running instance of tiptap:

import { Editor } from '@tiptap/core'
import extensions from '@tiptap/starter-kit'

new Editor({
  element: document.getElementsByClassName('element'),
  extensions: extensions(),
  content: '<p>Your content.</p>',
})

Vue.js

To use tiptap with Vue.js (and tools that are based on Vue.js) install the Vue.js adapter in your project:

# Using npm
npm install @tiptap/vue @tiptap/vue-starter-kit

# Using Yarn
yarn add @tiptap/vue @tiptap/vue-starter-kit

We even prepared a Vue.js starter kit for you. That should give you a good headstart. Create a new component and add the following content to get a basic version of tiptap:

CodeSandbox

CodeSandbox is an online coding environment. Its great to fiddle around without setting up a local project and its great to share your code with others.

Its also amazing for bug reports. Try to recreate a bug there and share it with us before you file an issue on GitHub. This helps a ton to fix bugs faster.

CDN

⚠️ This is broken and doesnt work. Dont use it. We are working on it.

<script src="https://cdn.jsdelivr.net/npm/tiptap@1.29.4/dist/tiptap.min.js"></script>