Skip to content

Commit c34f32f

Browse files
committed
Remove docusaurus template and add partial docs
1 parent 0aa5c9a commit c34f32f

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

49 files changed

+480
-793
lines changed

.github/workflows/build-docs.yml

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
name: Test deployment
2+
3+
on:
4+
pull_request:
5+
branches:
6+
- main
7+
# Review gh actions docs if you want to further define triggers, paths, etc
8+
# https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#on
9+
10+
jobs:
11+
test-deploy:
12+
name: Test deployment
13+
runs-on: ubuntu-latest
14+
steps:
15+
- uses: actions/checkout@v4
16+
with:
17+
fetch-depth: 0
18+
- uses: actions/setup-node@v4
19+
with:
20+
node-version: 20
21+
cache: npm
22+
23+
- name: Install dependencies
24+
run: npm ci
25+
working-directory: docs
26+
27+
- name: Test build website
28+
run: npm build
29+
working-directory: docs

README.md

Lines changed: 55 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -5,8 +5,6 @@ Pulse Editor
55
> [!IMPORTANT]
66
> Pulse Editor is still in its early development stage. We are trying hard to make sure everything works as expected for all different platforms. See [Beta Release Roadmap](#beta-release-roadmap) below.
77
8-
9-
108
<p align="center">
119
<img alt="Pulse Editor" src="shared-assets/icons/pulse_logo.svg"/>
1210
</p>
@@ -15,9 +13,11 @@ Pulse Editor
1513

1614
[![Discord](https://img.shields.io/badge/Discord-%235865F2.svg?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/s6J54HFxQp)
1715
[![Licence](https://img.shields.io/github/license/Ileriayo/markdown-badges?style=for-the-badge)](./LICENSE)
16+
1817
</div>
1918

2019
# Table of Contents
20+
2121
<span style="font-size: 16px;">
2222

2323
- [Table of Contents](#table-of-contents)
@@ -26,7 +26,7 @@ Pulse Editor
2626
- [Major Beta Release 1 (June 2025):](#major-beta-release-1-june-2025)
2727
- [Major Beta Release 2 (planned for 2025 Q3)](#major-beta-release-2-planned-for-2025-q3)
2828
- [Major Beta Release 3 (planned for 2025 Q4)](#major-beta-release-3-planned-for-2025-q4)
29-
- [Documentation (WIP)](#documentation-wip)
29+
- [Documentation and Guide](#documentation-and-guide)
3030
- [Getting Started -- User Guide](#getting-started----user-guide)
3131
- [Web Client](#web-client)
3232
- [Mobile Client](#mobile-client)
@@ -47,17 +47,21 @@ Pulse Editor
4747
</span>
4848

4949
# Introduction
50+
5051
Pulse Editor is a cross-platform tool built to make AI-powered creation and development feel intuitive and seamless.
5152

5253
# Beta Release Roadmap
53-
🎉🎉Pulse Editor is now in beta.
54+
55+
🎉🎉Pulse Editor is now in beta.
5456

5557
We plan to have 2-3 major beta release stages before we reach a stable release version.
5658

5759
### Major Beta Release 1 (June 2025):
60+
5861
Pulse Editor is now available on Android and Desktop (tested for Windows, needs more testing for Linux and MacOS).
5962

6063
Pulse Editor Marketplace now is available for editor users. Simply download Pulse Editor, and view all available extensions in the extension page. You can also browser and search extensions in [Marketplace Web (WIP)](https://pulse-editor.com/marketplace). As for now, the following extensions are available:
64+
6165
- (Official) [Pulse Editor Code View (MIT)](https://github.com/ClayPulse/pulse-editor-code-view)
6266
- (Official) [Pulse Editor Terminal (MIT)](https://github.com/ClayPulse/pulse-editor-terminal)
6367
- (Official) [Pulse Editor Image Editor (MIT)](https://github.com/Shellishack/pulse-editor-image-editor)
@@ -67,9 +71,10 @@ Pulse Editor Marketplace Developer Access is now open for application. If you'd
6771

6872
Even if you haven't got access to publish your extensions to the marketplace, you can still explore Pulse Editor platform by developing your own extensions locally. This is a great opportunity to get an early look at Pulse Editor and start experimenting with its capabilities! See [Extension Development](#pulse-editor-extension-development) below.
6973

70-
7174
### Major Beta Release 2 (planned for 2025 Q3)
75+
7276
Planned items:
77+
7378
- Documentation
7479
- Support for web
7580
- Support remote Pulse Editor instance access
@@ -79,102 +84,136 @@ Planned items:
7984
~~Coming Soon: [Making 100 Extension Apps Challenge](https://github.com/shellishack)~~
8085

8186
### Major Beta Release 3 (planned for 2025 Q4)
87+
8288
... (WIP)
8389

84-
# Documentation (WIP)
85-
The documentation will be available at https://docs.pulse-editor.com. You can find documentation repository [here](https://github.com/ClayPulse/docs).
90+
# Documentation and Guide
91+
92+
The documentation and user guide will be available at https://docs.pulse-editor.com. For documentation contributors, the docs source repository is located [here](docs/).
8693

8794
# Getting Started -- User Guide
95+
8896
## Web Client
89-
There is a web deployment at https://editor.claypulse.ai
97+
98+
There is a web deployment at https://web.pulse-editor.com
9099

91100
For detailed web user guide, check out [Web User Guide](web/README.md)
101+
92102
## Mobile Client
103+
93104
Android client is available in release page.
94-
>Current we only support Android, although it is technically possible to have an iOS build (see developer guide below).
105+
106+
> Current we only support Android, although it is technically possible to have an iOS build (see developer guide below).
95107
96108
For detailed mobile user guide, check out [Mobile User Guide](mobile/README.md)
109+
97110
## Desktop Client
111+
98112
Linux, MacOS, Windows clients are available in release page.
113+
99114
> [!NOTE]
100115
> Only Windows is tested in alpha release.
101116
102117
For detailed desktop user guide, check out [Desktop User Guide](desktop/README.md)
118+
103119
## VSCode Extension
120+
104121
A VSCode Webview Extension with limited features is available [here](https://marketplace.visualstudio.com/items?itemName=shellishack.pulse-editor).
105122

106123
For detailed VSCode extension user guide, check out [VSCode Extension User Guide](vscode-extension/README.md)
107124

108-
109125
# Getting Started -- Development Guide
126+
110127
## Recommended Nodejs version
128+
111129
Nodejs 20
130+
112131
## Install dependencies
132+
113133
You can install dependencies for all workspaces using
134+
114135
```
115136
npm i
116137
```
138+
117139
Or, for a specific workspace. e.g. for web:
140+
118141
```
119142
npm i --workspace=web
120143
```
121144

122145
## Install dependencies (desktop native modules)
146+
123147
When dependencies in `desktop/`, use Electron's nodejs instead of local nodejs.
124148

125149
Make sure you have installed necessary build tools.
150+
126151
### For Windows
152+
127153
Nodejs Windows Installer should already include windows-build-tools. In addition, make sure [Windows SDK](https://developer.microsoft.com/en-us/windows/downloads/windows-10-sdk) is also available:
128154

129155
### For Linux
156+
130157
```
131158
sudo apt install -y make python build-essential
132159
```
133160

134161
Then you can rebuild native dependencies in `desktop/` using.
162+
135163
```
136164
cd desktop
137165
npm run rebuild-native
138166
```
167+
139168
Electron may warn you need NODE_MODULE_VERSION xxx. If you have [email protected] installed (check desktop/package.json), you can run:
169+
140170
```
141171
electron-rebuild -v 35.0.2
142172
```
143173

144174
Start development:
175+
145176
```
146177
npm run desktop-dev
147178
```
179+
148180
Build production release:
181+
149182
```
150183
npm run desktop-build
151184
```
152185

153-
154186
## Web Development
155-
Pulse Editor uses Next.js as the frontend (and backend -- TBD).
156-
You can get started with local development by running:
187+
188+
Pulse Editor uses Next.js as the frontend (and backend -- TBD).
189+
You can get started with local development by running:
190+
157191
```bash
158192
npm run web-dev
159193
```
160194

161195
## Mobile Development
196+
162197
Pulse Editor uses Capacitor.js to create mobile apps on Android and iOS. To develop mobile app locally, try the following.
163198

164199
Start development:
200+
165201
```
166202
npm run android-dev
167203
```
168204

169205
Build production release
206+
170207
```bash
171208
# Production
172209
npm run android-build
173210
```
174211

175212
## Desktop Development
213+
176214
Pulse Editor uses Electron.js to create desktop apps on Windows, Mac and Linux. To develop desktop app locally,
177215
run:
216+
178217
```bash
179218
# Development
180219
npm run desktop-dev
@@ -185,6 +224,7 @@ npm run desktop-build
185224
If you run `npm run desktop-build` for a production build, you can find an executable file inside `build/desktop`.
186225

187226
## VSCode Extension Development
227+
188228
> [!warning]
189229
> The code in `vscode-extension` might be out of date, as it was made for an Alpha Demo.
190230
> Support for using Pulse Editor as an extension in VSCode might be discontinued, or get simply replaced with a webview.
@@ -194,9 +234,11 @@ Pulse Editor uses VSCode Webview API to create a VSCode Extension. To develop VS
194234
Note that you will also need to run the Nextjs server locally during development.
195235

196236
## Pulse Editor Extension Development
237+
197238
Pulse Editor uses [Modular Federation](https://module-federation.io/) to deliver its modular extensions.
198239
For guides on how to start developing and using extensions locally, check out our [React template repository](https://github.com/ClayPulse/pulse-editor-extension-template).
199240

200241
Some of our official extensions are also open-source. Feel free to take examples from them and/or contribute to them.
242+
201243
- [Pulse Editor Code View](https://github.com/ClayPulse/pulse-editor-code-view)
202244
- [Pulse Editor Terminal](https://github.com/ClayPulse/pulse-editor-terminal)

desktop/README.md

Lines changed: 0 additions & 42 deletions
This file was deleted.

docs/docs/api-reference/index.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
---
2+
sidebar_position: 1
3+
---
4+
5+
# Introduction
6+
This is
Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
{
2+
"label": "Development Guide",
3+
"position": 6
4+
}
Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
---
2+
sidebar_position: 1
3+
---
4+
5+
# Pulse Editor CLI
6+
7+
## Installation
8+
```bash
9+
npx -g install @pulse-editor/cli
10+
```
11+
12+
## Create extension project
13+
```bash
14+
pulse create
15+
```
16+
17+
## Publish extension to marketplace
18+
```bash
19+
pulse publish
20+
```
Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
# Develop Extensions
2+
3+
## Choose your framework
4+
5+
Pulse Editor uses [Module Federation](https://module-federation.io/guide/start/) to enable extension system. Thanks to the [Micro-Frontend](https://en.wikipedia.org/wiki/Micro_frontend) architecture of [Module Federation](https://module-federation.io/guide/start/), you can (technically) use any frontend web development framework to develop your extensions.
6+
7+
For you to get started quickly, we offer starter templates for the following frameworks
8+
9+
- React
10+
- More to come!
11+
12+
## Use Pulse Editor CLI
13+
14+
You can use Pulse Editor CLI tool to manage developer credentials, create projects, and publish extensions, etc. Check out the [cli guide](/docs/guide/develop-extensions/cli).
15+
16+
import DocCardList from '@theme/DocCardList';
17+
18+
<DocCardList />
Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
{
2+
"label": "Develop Extensions with React",
3+
"position": 2
4+
}
Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
# React
Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
# React Starter Template

0 commit comments

Comments
 (0)