Skip to content

Commit c5bac19

Browse files
authored
Readme (#37)
* exclude history, make blockgroup lowercase * update readme * update title * update commands / readme * add badges * add collab gif * update snaps * update comment
1 parent 58509da commit c5bac19

37 files changed

+163
-72
lines changed

.github/workflows/build.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -43,8 +43,8 @@ jobs:
4343
- name: Install Dependencies
4444
run: npm install
4545

46-
- name: Bootstrap packages
47-
run: npm run bootstrap
46+
# - name: Bootstrap packages
47+
# run: npm run bootstrap
4848

4949
- name: Lint packages
5050
run: npm run lint

.resources/animations.gif

1.65 MB
Loading

.resources/collaboration.gif

1.03 MB
Loading

.resources/dragdrop.gif

572 KB
Loading

.resources/nesting.gif

966 KB
Loading

.resources/placeholders.gif

565 KB
Loading

.resources/selectmenu.gif

2.29 MB
Loading

.resources/slashmenu.gif

1.69 MB
Loading

README.md

Lines changed: 76 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,72 @@
11
# BlockNote
22

3-
Welcome to the BlockNote editor. Let's build a block based WYSIWYG editor with killer UX!
3+
<a href="https://discord.gg/aDQxXezfNj"><img alt="Discord" src="https://img.shields.io/badge/Chat on discord%20-%237289DA.svg?&style=for-the-badge&logo=discord&logoColor=white"/></a>
4+
5+
[![npm version](https://badge.fury.io/js/%blocknote%2Fcore.svg)](https://badge.fury.io/js/%blocknote%2Fcore)
6+
7+
**Welcome to BlockNote editor: a "Notion-style" block-based extensible text editor built on top of [Prosemirror](https://prosemirror.net/) and [Tiptap](https://tiptap.dev/).**
8+
9+
# Live demo
10+
11+
Play with the editor @ [https://blocknote-main.vercel.app/](https://blocknote-main.vercel.app/).
12+
13+
(Source in [examples/editor](/examples/editor))
14+
15+
# Example code (React)
16+
17+
```typescript
18+
import { EditorContent, useEditor } from "@blocknote/core";
19+
import "@blocknote/core/style.css";
20+
21+
function App() {
22+
const editor = useEditor({
23+
onUpdate: ({ editor }) => {
24+
// Log the document to console on every update
25+
console.log(editor.getJSON());
26+
},
27+
});
28+
29+
return <EditorContent editor={editor} />;
30+
}
31+
```
32+
33+
# Features
34+
35+
BlockNote comes with a number of features and components to make it easy to embed a high-quality block-based editor in your app:
36+
37+
### Animations:
38+
39+
<img src="https://github.com/YousefED/BlockNote/blob/readme/.resources/animations.gif?raw=true" width="400" />
40+
41+
### Helpful placeholders:
42+
43+
<img src="https://github.com/YousefED/BlockNote/blob/readme/.resources/placeholders.gif?raw=true" width="400" />
44+
![placeholders](.resources/placeholders.gif)
45+
46+
### Drag and drop blocks:
47+
48+
<img src="https://github.com/YousefED/BlockNote/blob/readme/.resources/dragdrop.gif?raw=true" width="400" />
49+
![dragdrop](.resources/dragdrop.gif)
50+
51+
### Nesting / indentation with tab and shift+tab:
52+
53+
<img src="https://github.com/YousefED/BlockNote/blob/readme/.resources/nesting.gif?raw=true" width="400" />
54+
55+
### Slash (/) menu:
56+
57+
<img src="https://github.com/YousefED/BlockNote/blob/readme/.resources/slashmenu.gif?raw=true" width="400" />
58+
59+
### Format menu:
60+
61+
<img src="https://github.com/YousefED/BlockNote/blob/readme/.resources/selectmenu.gif?raw=true" width="400" />
62+
63+
### Real-time collaboration:
64+
65+
<img src="https://github.com/YousefED/BlockNote/blob/readme/.resources/collaboration.gif?raw=true" width="400" />
66+
67+
# Contributing
68+
69+
Directory structure:
470

571
```
672
blocknote
@@ -9,27 +75,26 @@ blocknote
975
└── tests - Playwright end to end tests
1076
```
1177

12-
# Development
13-
14-
We use [Lerna](https://lerna.js.org/) to manage the monorepo with separate packages.
15-
1678
## Running
1779

1880
To run the project, open the command line in the project's root directory and enter the following commands:
1981

2082
# Install all required npm modules for lerna, and bootstrap lerna packages
2183
npm install
22-
npm run bootstrap
2384

24-
# Start the editor project
85+
# Start the example project
2586
npm start
2687

27-
## Updating packages
28-
29-
If you've pulled changes from git that add new or update existing dependencies, use `npm run bootstrap` instead of `npm install` to install updated dependencies!
30-
3188
## Adding packages
3289

3390
- Add the dependency to the relevant `package.json` file (packages/xxx/package.json)
3491
- run `npm run install-new-packages`
3592
- Double check `package-lock.json` to make sure only the relevant packages have been affected
93+
94+
# Credits ❤️
95+
96+
BlockNote builds directly on two awesome projects; [Prosemirror](https://prosemirror.net/) by Marijn Haverbeke and [Tiptap](https://tiptap.dev/). Consider sponsoring those libraries when using BlockNote: [Prosemirror](https://marijnhaverbeke.nl/fund/), [Tiptap](https://github.com/sponsors/ueberdosis).
97+
98+
BlockNote is built as part of [TypeCell](https://www.typecell.org). TypeCell is proudly sponsored by the renowned [NLNet foundation](https://nlnet.nl/foundation/) who are on a mission to support an open internet, and protect the privacy and security of internet users. Check them out!
99+
100+
<a href="https://nlnet.nl"><img src="https://nlnet.nl/image/logos/NGIAssure_tag.svg" alt="NLNet" width="100"></a>

examples/editor/index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<meta charset="UTF-8" />
55
<!-- <link rel="icon" type="image/svg+xml" href="/src/favicon.svg" /> -->
66
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
7-
<title>Vite App</title>
7+
<title>BlockNote demo</title>
88
</head>
99
<body>
1010
<div id="root"></div>

0 commit comments

Comments
 (0)