Prerequisites
It is important that your computer is set up with the necessary packages before you begin development. You will come across a variety of errors if these prerequisites are not installed. The quick start guide explains how to run an automated install. This page details what programs and packages are needed to run and build Honeycomb. There are some OS-specific prerequisites needed to build a task as a desktop application.
OS Independent
Git
git is an open-sourced version control system. It is used to track changes, revert mistakes, and enable peer code reviews!
GitHub Desktop is a GUI application used to interact with git and GitHub directly from your computer. It is not strictly needed but many folks find it easier to work with than using git directly from the command line.
Node Version Manager
NodeJS is a cross-platform runtime environment for JavaScript code. Almost every web application today builds on top of node. Node Version Manager manages running multiple versions of node on the same system. The .nvmrc
denotes the version of node that Honeycomb uses.
Python
Python is a high-level programming language. Some "under the hood" tools needed by Honeycomb are written in python so it must be installed on your system.
Oracle JDk
Java is another high-level programming language that some tools are written in (namely, the Firebase Emulators). We must install a JDK (Java Development Kit) for it to run.
Honeycomb needs Java version 11 or later to run - the installers use version 18.
Visual Studio Code
Visual Studio Code is a well-loved and easy to use integrated development environment (IDE). This is the program you'll use to write your task.
Mac-specific Installs
X-Code
XCode is a special IDE for the Apple platform. It comes with everything needed to compile desktop applications from an Apple computer. It must be installed from the terminal:
xcode-select --install
Rosetta
Rosetta is a translation layer built for Mac computers with Apple Silicon. It should ask to be installed if any of the prerequisite tools need it. Otherwise, this guide can be used to make sure it is on your Apple Silicon system.
Manual Installation
macOS
The links below will take you to each project installation page should you prefer to manually install the prerequisite software.
Windows
The links below will take you to each project installation page should you prefer to manually install the prerequisite software.
Linux
The links below will take you to each project installation page should you prefer to manually install the prerequisite software. Your preferred installation method for the programs listed above should get you up and running on any Linux distro new enough to support GLIBC_2.28.
- Git
- GitHub Desktop
- NVM
- Python
- Oracle JDK
- VS Code
- Install Clang or follow installation instructions on the electron docs
- Development headers of
GTK 3
andlibnotify
(Follow installation instructions on the electron docs)