hyperspace-desktop-client-w.../README.md

97 lines
4.7 KiB
Markdown
Raw Normal View History

2019-03-25 21:00:18 +01:00
# Hyperspace v1.0
2019-05-12 21:07:35 +02:00
The new beautiful, fluffy client for the fediverse written in TypeScript and React
2019-03-25 21:00:18 +01:00
2019-03-26 02:37:02 +01:00
![Screenshot](screenshot.png)
2019-05-12 21:07:35 +02:00
[![Matrix room](https://img.shields.io/matrix/hypermasto:matrix.org.svg)](https://matrix.to/#/#hypermasto:matrix.org)
[![Discord server](https://img.shields.io/discord/554108687434907660.svg?color=blueviolet&label=discord)](https://discord.gg/c69AXwk)
![Build Status](https://github.com/hyperspacedev/hyperspace/workflows/Node%20CI/badge.svg)
2019-03-25 21:00:18 +01:00
2019-05-12 21:07:35 +02:00
Hyperspace is the fluffiest client for Mastodon and other fediverse networks written in TypeScript and React. Hyperspace offers a fun, clean, fast, and responsive design that scales beautifully across devices and enhances the fediverse experience.
2019-04-04 15:29:14 +02:00
2019-05-12 21:07:35 +02:00
> Note: For more information on how Hyperspace 1.0 is different from the *Hyperspace Classic (0.x)* series, please see [MIGRATING.md](MIGRATING.md).
## Build instructions
### Prerequisites
To develop Hyperspace, you'll need the following tools and packages:
- Node.js 8 or later
- (Optional) Visual Studio Code
### Installing dependencies
First, clone the repository from GitHub:
```bash
git clone https://github.com/hyperspacedev/hyperspace
```
Then, in the app directory, run the following command to install all of the package dependencies:
```npm
npm install
```
### Testing changes
Before testing Hyperspace, make the following change in `config.json`, located in the `public` directory:
```json
"location": "https://localhost:3000"
```
This is necessary to test Hyperspace locally and will need to be reverted after testing or before releasing to `master`.
2019-05-16 20:17:53 +02:00
> Note: if you are testing the **desktop** version of Hyperspace, replace `https://localhost:3000` with `desktop`.
To run a development version of Hyperspace, either run the `start` task from VS Code or run the following in the terminal:
```npm
npm start
```
The site will be hosted at `https://localhost:3000`, where you can sign in and test Hyperspace using your Mastodon account. If you have signed in before, you will be automatically logged in.
Alternatively, if you are testing the desktop version of Hyperspace, run `npm run electrify` (or `npm run electrify-nobuild`, if you don't want to make another production build). Hyperspace will open in a window where you can sign in and test Hyperspace with your Mastodon account. You'll be logged in automatically if you've signed in before.
2019-05-16 20:17:53 +02:00
### Building a release
To build a release, run the following command:
```npm
npm build
```
The built files will be available under `build` as static files. These files should get hosted to a web server.
2019-05-12 21:07:35 +02:00
#### Building desktop releases
You can run any of the following commands to build a release for the desktop:
- `build-desktop`: Builds the desktop apps for all platforms (eg. Windows, macOS, Linux). Will run `npm run build` before building.
- `build-desktop-win`: Builds the desktop app for Windows without running `npm run build`.
- `build-desktop-darwin`: Builds the desktop apps for macOS (eg. disk image, Mac App Store) without running `npm run build`.
- `build-desktop-linux`: Builds the desktop apps for Linux (eg. Debian package, AppImage, and Snap) without running `npm run build`.
- `build-desktop-linux-select`: Builds the desktop app for Linux without running `npm run build`. _Target is required as a parameter._
> Note: If you are building the macOS version of Hyperspace, add your provisioning profiles and entitlements files in the `desktop` folder and ensure you have installed your developer certificates on your machine before running `build-desktop` or `build-desktop-darwin`.
>
> While the command will run without needing the signature, it is recommended that you make a signed copy to protect users.
> ⚠️ **Notarization**: If you are building the macOS version of Hyperspace, you will also need to set up notarization processes. Hyperspace will _not_ run on devices running macOS Catalina or later without this notarization; please ensure you have the correct certificates and updated notarization scripts in `desktop/notarize.js`.
>
> When building, the script will aotumatically notarize the app for you after signing it.
2019-05-12 21:07:35 +02:00
The built files will be available under `dist` that can be uploaded to your app distributor or website.
## Contribute
Contrubition guidelines are available in the [contributing file](.github/contributing.md) and when you make an issue/pull request. Additionally, you can access our [Code of Conduct](.github/code_of_conduct.md).
2019-05-19 19:09:22 +02:00
If you want to aid the project in other ways, consider supporting the project on [Patreon](https://patreon.com/marquiskurt). You can also [view all of our contributors](patreon.md) that help make Hyperspace possible.
If you have Matrix, you can join the Hyperspace community ([+hyperspace-masto:matrix.org](https://matrix.to/#/+hyperspace-masto:matrix.org)).