Rails Template

Overview:

The Ackama Rails Template is a set of features and configurations that the Ackama Ruby team uses as the starting point for creating new Rails applications. It is based on their experience of creating and maintaining Rails applications for over 10 years. The template includes various features and configurations aimed at improving the development process, security, error reporting, code style, and testing.

Features:

• General:
  • Uses puma as the application server.
  • Uses Yarn for managing JavaScript packages.
  • Uses PostgreSQL as the database (only supports PostgreSQL).
  • Includes a much-improved bin/setup script.
  • Includes dotenv for environment variable management.
  • Creates a doc/ directory for documentation.
  • Adds a middleware to implement HTTP Basic Auth using environment variables.
  • Uses okcomputer for health check endpoints.
  • Installs lograge for improved logs in production.
  • Uses app/services as the place to hold plain Ruby objects for business logic.
  • Overrides the default ActiveStorage base controller for authentication decisions.
• Security:
  • Configures osv-detector to run in CI.
  • Installs and configures brakeman for vulnerability scanning.
  • Adds a well-documented Content Security Policy initializer with secure defaults.
  • Creates .well-known/security.txt for security information.
• Error Reporting:
  • Sets up Sentry for error reporting.
• Code Style:
  • Includes EditorConfig config file (.editorconfig).
  • Sets up Prettier for JavaScript/HTML/CSS with an Ackama config.
  • Sets up ESLint for JavaScript using Ackama's rules.
  • Uses stylelint for styles.
  • Includes Rubocop for Ruby with Ackama settings.
  • Installs Overcommit for managing custom Git hooks.
  • Uses erb_lint to lint HTML in ERB and runs Rubocop on Ruby snippets within ERB.
• Testing:
  • Uses RSpec for tests.
  • Installs webdrivers for automated browser testing.
  • Includes Simplecov for test coverage.
  • Enables debugging system specs using a visible browser (not headless).
  • Sets up automated accessibility testing using axe and lighthouse.
  • Includes Axe Matchers gem for checking accessibility compliance of views.

Summary:

The Ackama Rails Template is a comprehensive set of features and configurations that the Ackama Ruby team uses as a starting point for creating new Rails applications. It includes various improvements for development, security, error reporting, code style, and testing. By using this template, teams can benefit from the experience and best practices of the Ackama Ruby team, ensuring a solid foundation for their Rails applications.