https://github.com/KieranP/rails-graphql-svelte

A starter template for a Rails+GraphQL API and Svelte frontend.
https://github.com/KieranP/rails-graphql-svelte

bootstrap graphql jwt rails ruby-on-rails svelte sveltekit

Last synced: about 1 month ago
JSON representation

A starter template for a Rails+GraphQL API and Svelte frontend.

• Host: GitHub
• URL: https://github.com/KieranP/rails-graphql-svelte
• Owner: KieranP
• Created: 2020-12-11T07:58:02.000Z (about 4 years ago)
• Default Branch: main
• Last Pushed: 2024-10-17T23:37:57.000Z (3 months ago)
• Last Synced: 2024-10-25T01:39:01.117Z (2 months ago)
• Topics: bootstrap, graphql, jwt, rails, ruby-on-rails, svelte, sveltekit
• Language: Ruby
• Homepage:
• Size: 3.33 MB
• Stars: 14
• Watchers: 2
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Starter Template: Rails + GraphQL + Svelte

This repo contains a starter template for a Rails+GraphQL API and SvelteKit frontend.

## Features

### Backend

The backend is powered by Ruby on Rails, with a GraphQL API.

It includes a secure JWT & 2FA authentication system, and authorisation using Pundit.

It is pre-wired with ActionCable/SolidCable for Websockets, and ActiveJob/SolidQueue for Background Processing.

It uses RSpec and Capybara for feature tests, and Rubocop/Brakeman for code analysis/quality.

It contains a basic config for Github Actions.

### Frontend

The frontend is powered by SvelteKit, and compiled using Vite.

Routing is handled by SvelteKit, and API requests made using Apollo.

Styling is provided by Bootstrap, and websockets via ActionCableJS.

It uses Prettier and ESLint +plugins for code analysis/quality.

Frontend runtime via Bun. Dependencies managed by Yarn.

## Usage

* Clone Git Repo

* Adjust `config/database.yml`

* `bundle install`

* `yarn install`

* `bin/rake db:setup`

* `bin/rspec`

* `overmind start` (or `foreman`, `hivemind`, etc)

* Open https://app.localhost

## File Structure

### Backend

The backend is powered by a standard Ruby on Rails app. The only exception is that Sprockets is not included for asset management and there are no Rails views templates. All HTML/CSS/JS compilation is handled by Vite.

### Frontend

When Vite runs, it clears the contents of `/public`, then takes the contents of `/app/frontend` and compiles them together into `/public`. The result is a frontend application that is embedded into a Ruby on Rails app for ease of development, whilst still being able to be extracted and deployed to a CDN for production. Frontend configs are managed via `vite.config.js` and `svelte.config.js`