tiger773131/Trekkwire-Rails-App

Requirements

You'll need the following installed to run the template successfully:

Ruby 3.0 or higher
Node.js v18
PostgreSQL 12 or higher - brew install postgresql
Redis - For ActionCable support (and Sidekiq, caching, etc)
Libvips or Imagemagick - brew install vips imagemagick
Yarn - npm install --global yarn Install Yarn
Overmind or Foreman - brew install tmux overmind or gem install foreman - helps run all your processes in development
Stripe CLI for Stripe webhooks in development - brew install stripe/stripe-cli/stripe

All Homebrew dependencies are listed in Brewfile, so you can install them all at once like this:

brew bundle install --no-upgrade

Then you can start the database servers:

brew services start postgresql
brew services start redis

Initial Setup

First, edit config/database.yml and change the database name.

Run bin/setup to install Rubygem and Javascript dependencies. This will also install foreman system wide for you and setup your database.

bin/setup

Optionally, you can rename the application name in config/application.rb. This won't affect anything, so it's not too important.

You can also rename the app in the Jumpstart config UI which updates the app name in the navbar, footer, etc.

Running Jumpstart Pro

To run your application, you'll use the bin/dev command:

bin/dev

This starts up Overmind (or fallback to Foreman) running the Procfile.dev config.

We've configured this to run the Rails server, CSS bundling, and JS bundling out of the box. You can add background workers like Sidekiq, the Stripe CLI, etc to have them run at the same time.

Here's a couple of useful Overmind commands:

# Debugging with byebug: 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

Windows Support

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

Alternatively, if you'd like to use Docker on Windows, you'll need to make sure you clone the repository and preserve the Linux line endings.

git clone git@github.com:username/myrepo.git --config core.autocrlf=input

Running with Docker Compose

We include a sample Docker Compose configuration that runs Rails, Postgresql, and Redis for you.

Simply run:

docker-compose up

Then open http://localhost:3000

Running with Docker

If you'd like to run Jumpstart Pro with Docker directly, you can run:

docker build --tag myapp .
docker run -p 3000:3000 myapp

If you'd like to use the fullstaq-ruby or other Dockerfile you can specify them as:

docker build -f ./Dockerfile.fullstaq-ruby .

tiger773131 / Trekkwire-Rails-App