No Description

anxgang cf09c0203b Merge branch 'master' of https://github.com/excid3/jumpstart 5 years ago
.github f0a06757ac Create FUNDING.yml 5 years ago
app 4eb0fc8caf add breadcrumbs_on_rails 5 years ago
config 4eb0fc8caf add breadcrumbs_on_rails 5 years ago
lib a0ab0d39af add simple_form 5 years ago
.foreman 8adcc695ff Add Rails 6 support and move all Javascript to webpacker 5 years ago
.gitignore d538d2e5b3 Added sitemap generator (#50) 6 years ago
CHANGELOG.md 8adcc695ff Add Rails 6 support and move all Javascript to webpacker 5 years ago
LICENSE 4afd959fff Create LICENSE (#31) 6 years ago
Procfile 8adcc695ff Add Rails 6 support and move all Javascript to webpacker 5 years ago
Procfile.dev 7b416caeed Use bundle exec to help with version problems 5 years ago
README.md cf09c0203b Merge branch 'master' of https://github.com/excid3/jumpstart 5 years ago
template.rb cf09c0203b Merge branch 'master' of https://github.com/excid3/jumpstart 5 years ago

README.md

👉 We've also built Jumpstart Pro which is a version of Jumpstart that includes payments with Stripe & Braintree, team accounts, TailwindCSS, and much more.

Jumpstart Rails Template

All your Rails apps should start off with a bunch of great defaults. It's like Laravel Spark, for Rails.

Note: Requires Rails 5.2 or higher

Want to see how it works? Check out the Jumpstart walkthrough video:

Jumpstart Ruby on Rails Template Walkthrough

Getting Started

Jumpstart is a Rails template, so you pass it in as an option when creating a new app.

Requirements

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

  • Ruby 2.5 or higher
  • Redis - For ActionCable support
  • bundler - gem install bundler
  • rails - gem install rails
  • Yarn - brew install yarn or Install Yarn
  • Foreman (optional) - gem install foreman - helps run all your processes in development

Creating a new app

rails new myapp -d postgresql -m http://gogs.anxgang.com/Hiskio/jumpstart/raw/master/template.rb

Or if you have downloaded this repo, you can reference template.rb locally:

rails new myapp -d postgresql -m template.rb

To run your app, use foreman start.

This will run Procfile.dev via foreman start -f Procfile.dev as configured by the .foreman file and will launch the development processes rails server, sidekiq, and webpack-dev-server processes. You can also run them in separate terminals manually if you prefer.

A separate Procfile is generated for deploying to production.

Authenticate with social networks

We use the encrypted Rails Credentials for app_id and app_secrets when it comes to omniauth authentication. Edit them as so:

EDITOR=vim rails credentials:edit

Make sure your file follow this structure:

secret_key_base: [your-key]
development:
  github:
    app_id: something
    app_secret: something
    options:
      scope: 'user:email'
      whatever: true
production:
  github:
    app_id: something
    app_secret: something
    options:
      scope: 'user:email'
      whatever: true

With the environment, the service and the app_id/app_secret. If this is done correctly, you should see login links for the services you have added to the encrypted credentials using EDITOR=vim rails credentials:edit

Cleaning up

rails db:drop
spring stop
cd ..
rm -rf myapp