# botcasts

**Repository Path**: mirrors_thoughtbot/botcasts

## Basic Information

- **Project Name**: botcasts
- **Description**: Botcasts is a Hotwire-powered podcast player and Hotwire Essentials is the associated tutorial to learn how build it yourself.
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-12-06
- **Last Updated**: 2026-03-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🤖 Botcasts

**Hotwire-powered Podcast Player** 🔌

The app starts as a Turbo-less Rails app. The goal is to progressively enhance
it using [Hotwire][].

[Hotwire]: https://hotwired.dev

## Requirements

- Ruby `3.3.0`
- [libvips](https://www.libvips.org/install.html)

## ⚙️ Setup

If this is your first time running the application, run `./bin/setup` to
install dependencies and seed the database.

## 🏗 Running the application

Run `./bin/dev` to start the development server and then navigate to
[http://localhost:3000](http://localhost:3000).

> [!NOTE]
> Running `./bin/dev` will enqueue background jobs to import the episodes.
> It will take a few minutes.

If you run into issues due to a podcast or episode not being
found when accessing the app, check the jobs statuses
on [http://localhost:3000/good_job](http://localhost:3000/good_job).

## 🚀 Hotwire Essentials: Getting started

Hotwire Essentials is a tutorial that takes you step-by-step through building a functional podcast player that teaches you how to apply Hotwire patterns to solve real-world problems. Each lesson builds on the previous one, with challenges that guide you through Turbo's capabilities, Stiumlus controllers, and best practices for server-driven interactivity.

Once you've setup the application locally, you are ready to start the [lesson plan][].

[lesson plan]: ./lessons/README.md

## Contributing

Please see [Contributing](./CONTRIBUTING.md).

## Additional resources

For more Hotwire resources, check out our [Hotwire resources][] and [blog posts][].

[Hotwire resources]: https://thoughtbot.com/services/hotwire-stimulus-turbo-frontend-development
[blog posts]: https://thoughtbot.com/blog/tags/hotwire

## About thoughtbot

![thoughtbot](https://thoughtbot.com/thoughtbot-logo-for-readmes.svg)

This repo is maintained and funded by thoughtbot, inc.
The names and logos for thoughtbot are trademarks of thoughtbot, inc.

We love open source software!
See [our other projects][community].
We are [available for hire][hire].

[community]: https://thoughtbot.com/community?utm_source=github
[hire]: https://thoughtbot.com/hire-us?utm_source=github