👷 Core Team (maintainers)
📦 Download App
🖥 Desktop
📱 Mobile
💥 Have some troubles?
If you don't know how to use the app, please create a discussion on our Q&A discussion page.
If you find a bug, please create an issue to our GitHub issue tracker.
If it is urgent or private, please join our Slack channel and send a direct message to @rokt33r.
🤲 Wanna contribute?
If you're interested in our project, you can participate in many different ways.
- Sharing your idea
- Helping community
- Resolving existing issues
Read our contributing guide, to learn about our development process, how to propose bugfixes and improvements.
Sharing your idea
To improve the app, we need your idea! It could be a new feature or an improvement for existing features. If you have any, please create a discussion in Feature Requests category.
Helping community
There are many ways to help our community. You can share how you're using our app by writing an article. You can write it in General discussion page, external developer community (Dev.to or Reddit) and your blog if you have one.
Also, you can help other users by answering their questions in here.
Resolving existing issues
We have left the "help wanted" label to some issues which external contributors could try to resolve. Some of them might have a small bounty so you can get a cup of coffee from it after hacking. If you find any interesting issues but their specs are not clear or you don't know how to fix them, please leave a comment on the issues. Then, we will give you more instructions.
Development
Currently, we provide the frontend source code only so you cannot host our backend server by yourself. But you can participate in development via mock backend mode. Although it still doesn't cover every API yet, you can access the basic folder and document management.
How to run the app
Create .env file.
NODE_ENV=development
MOCK_BACKEND=true
Run webpack processors. You have to run them in separate terminals.
npm run dev:cloud
# You can skip next two scripts if you don't need to run electron app.
npm run dev:electron
npm run dev:webpack
How to extend mock backend
When the mode is enabled, all API calls will be passed to src/cloud/api/mock/mockHandler.ts
.
The source code is quite similar to a router interface. All you need to is method
, pathname
and a handler function. So, when you confront Not Found
error while calling GET /api/something
, you can simply add a mock route like below.
{
method: 'get',
pathname: 'api/something',
handler: ({ search }): GetSomethingResponse => {
return {
...something
}
},
}
Scripts
- Development scipts
npm run dev:cloud
: Run webpack for the cloud spacenpm run dev:webpack
: Run webpack for the desktop app main window renderernpm run dev:electron
: Run webpack for the desktop app main processornpm run dev:mobile
: Run webpack for the mobile appnpm run lint
: Check lint errorsnpm run format
: Try to fix lint errors automaticallynpm test
: Run test scriptnpm run tsc
: Check type errors
- Build scripts
npm run build:electron-production
: Build assets for the desktop appnpm run build:cloud-production
: Build asssets for the cloud spacenpm run build:mobile-production
: Build assets for the mobile appnpm start
: Run the desktop app with prebuilt assetsnpm run meta
: Prepare meta data for the desktop app building(Generate package.json for electron-build module)npm run prepack
: Create desktop app installers without signingnpm run release
: Create desktop app installers for production and upload them to GitHub