meshtastic/README.md

71 lines
2.6 KiB
Markdown
Raw Normal View History

2021-02-18 17:05:59 -08:00
<!-- markdownlint-disable MD033 -->
<!-- markdownlint-disable MD041 -->
<div align="center">
<img src="https://raw.githubusercontent.com/meshtastic/meshtastic-design/4463325bedef20be5655c91c80d1cd32a625f3ff/logo/svg/Mesh_Logo_Dynamic.svg" width="256">
<h1>Meshtastic</h1>
<span>
<a href="https://www.meshtastic.org" target="_blank">
2022-03-08 03:49:40 -08:00
<img src="static/img/readme/globe.svg" width="16" />
2021-02-18 17:05:59 -08:00
Website
</a>
<span>&nbsp;&nbsp;&nbsp;&nbsp;</span>
<a href="https://meshtastic.discourse.group" target="_blank">
2022-03-08 03:49:40 -08:00
<img src="static/img/readme/comment-alt.svg" width="16" />
2021-02-18 17:05:59 -08:00
Forum
</a>
<span>&nbsp;&nbsp;&nbsp;&nbsp;</span>
<a href="https://discord.gg/UQJ5QuM7vq" target="_blank">
2022-03-08 03:49:40 -08:00
<img src="static/img/readme/discord.svg" width="16" />
Discord
2021-02-18 17:05:59 -08:00
</a>
<span>&nbsp;&nbsp;&nbsp;&nbsp;</span>
<a href="https://play.google.com/store/apps/details?id=com.geeksville.mesh" target="_blank">
2022-03-08 03:49:40 -08:00
<img src="static/img/readme/google-play.svg" width="16" />
2021-02-18 17:05:59 -08:00
App
</a>
</span>
<br />
<hr />
</div>
## What is Meshtastic?
Meshtastic® is a project that lets you use inexpensive LoRa radios as a long range off-grid communicator for areas without reliable cellular service. These radios are great for hiking, skiing, paragliding - essentially any hobby where you don't have reliable internet access. Each member of the mesh can send and view text messages and enable optional GPS based location features.
2021-02-18 17:05:59 -08:00
2021-06-07 13:22:21 -07:00
The radios automatically create a mesh to forward packets as needed, so everyone in the group can receive messages from even the furthest member. The radios will optionally work with your phone, but no phone is required.
2021-06-07 14:08:14 -07:00
2022-01-02 22:53:45 -08:00
Meshtastic uses LoRa for the long range communications and depending on settings used, the maximum theoretical group size ranges from 30-200 device nodes. Currently each device can only support a connection from a single user at a time.
Please see our [website](https://meshtastic.org) for more information about Meshtastic.
2021-12-21 03:44:01 -08:00
[![Powered by Vercel](https://raw.githubusercontent.com/abumalick/powered-by-vercel/master/powered-by-vercel.svg)](https://vercel.com?utm_source=meshtastic&utm_campaign=oss)
2022-01-31 06:25:10 -08:00
## Installation
2022-03-08 03:49:40 -08:00
nodejs is required in your dev. environment. The method for installing nodejs depends on your operating system. This software is built using [Docusaurus](https://docusaurus.io).
2022-01-31 06:25:10 -08:00
Fork then clone the repository:
```bash
2022-02-08 04:48:24 -08:00
git clone https://github.com/meshtastic/meshtastic
2022-01-31 06:25:10 -08:00
```
Go to the root directory of your repository and install dependencies:
```bash
yarn install
```
Build the project with the following command
```bash
yarn build
```
Start a local dev. instance with the following command
```bash
yarn start
```