Feather-Page CMS is a Ruby on Rails application that provides a web interface for managing small static websites. It generates static sites directly using Rails ERB templates and provides a simple management UI.

• A simple interface that can be used by non-technical users.
• Website should look like a real web-developer hand-coded them.
• Deployed websites should be static.
• Deployed websites should NOT load any external resources.
• Deployed websites should be as small as possible.
• Deployed websites should be SEO friendly.
• Deployed websites are on domains that belong to the user.

• Ruby: 4.0.1 (as specified in Gemfile)
• Node.js & npm: Required for JavaScript assets and Jest tests.
• System Dependencies:
  • rclone: Used for syncing files to deployment targets.
  • libvips: Image processing library.
  • PostgreSQL: Database.

1. Install system dependencies:

   brew install rclone libvips postgresql

2. Install Ruby dependencies:

   bundle install

3. Install JavaScript dependencies:

   npm install

4. Prepare the database:

   cp .env.example .env # Configure your database credentials
   rails db:create
   rails db:schema:load

   Alternatively, you can use:

   bin/setup

To start the Rails server along with background workers (Sidekiq) and other services:

foreman start

Or start just the Rails server:

bin/dev
# or
rails s

The CMS supports header images with Unsplash integration for posts and pages.

1. Create an account at https://unsplash.com/developers
2. Create a new application (select "Demo" for testing)
3. Copy your Access Key
4. Configure credentials:

   EDITOR=nano rails credentials:edit

5. Add your Unsplash access key:

   unsplash:
     access_key: YOUR_ACCESS_KEY_HERE

6. Save and close the editor

Alternatively, you can set the UNSPLASH_ACCESS_KEY environment variable in your .env file.

Note: Without Unsplash credentials, users can still upload header images manually - they just won't be able to search Unsplash.

• bin/setup: Automated setup and database preparation.
• bin/dev: Starts the Rails server.
• npm run lint: Runs JavaScript linting (standard).
• bundle exec rubocop: Runs Ruby linting.

bundle exec rspec

npm test

• app/interactions/: Business logic organized using the LightService gem.
• app/components/: Reusable UI elements using ViewComponent.
• app/javascript/: Modern JavaScript using Import Maps.
• spec/: Comprehensive test suite (RSpec and Jest).
• config/deploy.yml: Kamal deployment configuration.

This project uses Kamal for deployment.

kamal lock release -d production
kamal envify -d production
kamal accessory boot all -d production
kamal deploy -d production

TODO: Add license information.