Installation

Installing Jumpstart Pro

To install dependencies, set up, and configure your application follow the latest instructions in the repository:

Rails Installation

iOS Installation

Android Installation

Screencast

This screencast will walk you through cloning Jumpstart Pro's git repository, installing dependencies, and setting up your brand new application so you can easily merge updates from git.

Development

Jumpstart Pro provides useful configurations to make development easier which are mentioned in more detail below.

Processes

Use the bin/dev command to run your application's processes.

As usual, you'll need to run several processes in development.

• rails server - starts your Rails application server.
• yarn run build - bundles Javascript using esbuild
• yarn run build:css - bundles CSS using Tailwind CLI and PostCSS
• sidekiq - or whatever background worker process you have configured

These commands are defined in Procfile and Procfile.dev so they can be started and shutdown together.

You'll also need to make sure the PostgreSQL, Redis, etc servers are installed and running externally.

Overmind & Foreman

Overmind and Foreman are process managers that start/stop the processes defined in Procfile.dev. Overmind is recommended because it allows you to join a process and interact with it. Unfortunately, Foreman is incompatible with binding.irb, pry, or similar debuggers therefore you cannot join and interact with a process as you can with Overmind.

Install Overmind with Homebrew:

brew install tmux overmind

You can then run your application anytime with:

bin/dev

Overmind Tips

# Debugging with byebug, binding.irb, etc: connect to the `web` process to be able to input commands:
overmind connect web
# Then disconnect by hitting [Ctrl+B] (or your tmux prefix) and then [D].

# Restart a process without restarting all the other ones:
overmind restart web

# If something goes wrong, you can kill all running processes:
overmind kill

Devcontainers & Docker

If you'd like to use Docker, Rails provides a devcontainer that uses Docker Compose to set up dependencies for consistent development across any OS.

To use the devcontainer, you will need to open the directory in VS Code code . and select "Reopen in Container" when prompted.

Once inside the Devcontainer, you can run Rails as normal using bin/dev in VS Code's terminal. Ports will be forwarded from OS localhost to the devcontainer.

bin/dev

Then open http://localhost:3000

Developing on Windows

If you'd like to run Jumpstart Pro Rails on Windows, we recommend using WSL2. You can find instructions here: https://gorails.com/setup/windows

The Devcontainer is also a great option for development on Windows.