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: 5 days 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 (almost 4 years ago)
• Default Branch: main
• Last Pushed: 2024-10-17T23:37:57.000Z (20 days ago)
• Last Synced: 2024-10-25T01:39:01.117Z (13 days 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 for Websockets, and SolidQueue for background processing.

It includes Rspec and Capybara for feature tests, and Rubocop/Brakeman for code analysis.

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.

Dependency management and development runtime are handled via Bun.

## Usage

* Clone Git Repo

* Adjust `config/database.yml`

* `bundle install`

* `bun install`

* `bin/rake db:setup`

* `bin/rspec`

* `foreman start`

## 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`