A weekly planning app for homeschooling families. Tracks daily subject completion, supports "Pick 1" curriculum choices, and captures learning narrations (text, voice, photo).

• Framework: Rails 8.1 with Hotwire (Turbo + Stimulus)
• Database: SQLite with Solid Queue/Cache/Cable
• Styling: Tailwind CSS 4
• Ruby: 3.4.4
• Deployment: Kamal 2 with Docker (GitHub Container Registry)
• Server: Thruster + Puma

• Ruby 3.4.4 (see .ruby-version)
• SQLite 3

bundle install
bin/rails db:prepare

bin/dev  # Starts Rails server + Tailwind CSS watcher

The app will be available at http://localhost:3000.

bin/rails test       # Run test suite
bin/rubocop          # Run linter
bin/ci               # Run full CI suite (tests + linter + security)

CI runs automatically on pushes to main and on pull requests via GitHub Actions. It includes:

• Rubocop style checks
• Bundler audit (gem vulnerabilities)
• Importmap audit (JavaScript dependencies)
• Brakeman security analysis
• Rails tests
• Seed data replication test

The app is deployed with Kamal 2 as Docker containers to a VPS, using GitHub Container Registry (ghcr.io).

Both environments run on the same VPS with separate data volumes and service names.

# Production
kamal deploy

# Staging
kamal deploy -d staging

These work for both environments (add -d staging for staging):

kamal console           # Rails console
kamal shell             # Bash shell on the server
kamal logs              # Tail application logs
kamal dbc               # Database console

This software is licensed under the O'Saasy License.

You may use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of this software, subject to the restriction that you may not use it to directly compete with the original author by offering it to third parties as a hosted, managed, or Software-as-a-Service (SaaS) product.

See LICENSE for the full text.