An open API service indexing awesome lists of open source software.

https://github.com/hopsoft/stimulus_todomvc

[WIP] An implementation of TodoMVC using Ruby on Rails and StimulusJS
https://github.com/hopsoft/stimulus_todomvc

reactive ruby-on-rails server-side-rendering single-page-app spa stimulus stimulusjs todo-mvc todomvc todomvc-demo

Last synced: about 17 hours ago
JSON representation

[WIP] An implementation of TodoMVC using Ruby on Rails and StimulusJS

Awesome Lists containing this project

README

        

[![Lines of Code - app directory](http://img.shields.io/badge/lines_of_code-203-brightgreen.svg?style=flat)](http://blog.codinghorror.com/the-best-code-is-no-code-at-all/)
[![Maintainability](https://api.codeclimate.com/v1/badges/29a9696b3c2a1fb6d4fb/maintainability)](https://codeclimate.com/github/hopsoft/stimulus_todomvc/maintainability)
[![Ruby Style Guide](https://img.shields.io/badge/code_style-standard-brightgreen.svg)](https://github.com/testdouble/standard)

# Stimulus TodoMVC

An implementation of [TodoMVC](http://todomvc.com) using
[Ruby on Rails](https://rubyonrails.org) and [StimulusJS](https://stimulusjs.org).

Expands on the original goals of [TodoMVC](http://todomvc.com) by providing a full application...
including a server and database.

## Table of Contents

- [Demo](#demo)
- [Why](#why)
- [Local Setup](#local-setup)
- [Next Steps](#next-steps)

## Demo

https://stimulus-todomvc.herokuapp.com

_You may notice some latency related to hosting on **free tier** services._

## Why

Many developers are unaware that it's possible to build responsive _"modern"_
[Single Page Applications (SPAs)](https://en.wikipedia.org/wiki/Single-page_application) with default Rails tooling.

The user experience may not strictly match what's promised by [pure JavaScript solutions](http://todomvc.com),
but it is **good enough** for the vast majority of use cases.
_Especially when you consider the deveopment, deployment, operating, and maintenance costs._

## Local Setup

1. Install dependencies

- [Ruby](https://www.ruby-lang.org/en/downloads/)
- [Yarn](https://yarnpkg.com/lang/en/docs/install/#mac-stable)
- [PostgreSQL](https://www.postgresql.org/download/)

1. Clone the repo

```sh
git clone https://github.com/hopsoft/stimulus_todomvc.git
```

1. Switch into the project folder

```sh
cd stimulus_todomvc
```

1. Run the setup command

```sh
bin/setup
```

1. Start the rails server

```sh
bin/rails server
```

1. See the app in action

To see the application in action, open a browser window and navigate to http://localhost:3000. That's it!

## Next Steps

If you find this approach lacking, consider giving [StimulusReflex](https://github.com/hopsoft/stimulus_reflex)
a try before reaching for a complex JavaScript framework.

## Contributing

This project uses [Standard](https://github.com/testdouble/standard)
and [Prettier](https://github.com/prettier/prettier) to minimize bike shedding related to code formatting.

Please run `./bin/standardize` prior submitting pull requests.