domchristie / rubyvideo

Indexing all Ruby related videos

Rubyvideo.dev

Rubyvideo.dev, inspired by pyvideo.org, is designed to index all Ruby-related videos from conferences and meetups worldwide. The site is currently in its Alpha release phase, and only a small portion of available videos has been indexed.

Contributing

This project is open source, and contributions are greatly appreciated. One of the most direct ways to contribute at this time is by adding more content. For more information on contributing, please visit this page.

Getting Started

Environment Variables

You can use the .env.sample file as a guide for the environment variables required for the project. However, there are currently no environment variables necessary for simple app exploration.

Setup

To prepare your database and seed content, run:

bin/setup

Meilisearch

Rubyvideo.dev search uses Meilisearch as a search engine.

To start the app, you need to have Meilisearch installed locally.

Most likely, when you run the seed process, Meilisearch won't start, and the index will not be created.

To create the index, start Meilisearch (bin/dev will start it), and in the console, run Talk.reindex!

This will create the local index and enable search.

Starting the Application

The following command will start Rails, Vite (for CSS and JS), and Meilisearch.

bin/dev

Experimental Page Transition API

page-transition2.mp4

Rubyvideo.dev offers experimental support for the Page View Transition API, recently released by Chrome.

Enabling page transitions with Turbo started with the addition of the following code:

addEventListener("turbo:before-render", (event) => {
  if (document.startViewTransition) {
    event.preventDefault();

    document.startViewTransition(() => {
      event.detail.resume();
    });
  }
});

The rest of the implementation was guided by examples you can find here: https://glitch.com/edit/#!/simple-set-demos?path=1-cross-fade%2Fscript.js%3A1%3A0

Currently, the implementation requires two Stimulus controllers. One controller adds a page transition class to an element on a click (before the navigation), and the other clears the DOM from any remaining view-transition-name on the page. It's crucial to ensure there is only one view-transition-name= the name per page. Plans are in place to improve this system and potentially remove the latter controller. This feature is still very much experimental.

Code of Conduct

Please note that this project is released with a Contributor Code of Conduct. By participating in this project, you agree to abide by its terms. More details can be found in the Code of Conduct document.

License

Rubyvideo.dev is open source and available under the MIT License. For more information, please see the License file.