better_app_gen 0.1.0

data/lib/better_app_gen/templates/root/gitignore.erb

@@ -0,0 +1,404 @@
+# Created by https://www.toptal.com/developers/gitignore/api/windows,linux,macos,visualstudiocode,rubymine,webstorm,rails,ruby,direnv,dotenv,node,sass
+
+### direnv ###
+.direnv
+.envrc
+
+### dotenv ###
+.env
+.env.docker
+
+### Linux ###
+*~
+
+# temporary files which can be created if a process still has a handle open of a deleted file
+.fuse_hidden*
+
+# KDE directory preferences
+.directory
+
+# Linux trash folder which might appear on any partition or disk
+.Trash-*
+
+# .nfs files are created when an open file is removed but is still being accessed
+.nfs*
+
+### macOS ###
+# General
+.DS_Store
+.AppleDouble
+.LSOverride
+
+# Icon must end with two \r
+Icon
+
+
+# Thumbnails
+._*
+
+# Files that might appear in the root of a volume
+.DocumentRevisions-V100
+.fseventsd
+.Spotlight-V100
+.TemporaryItems
+.Trashes
+.VolumeIcon.icns
+.com.apple.timemachine.donotpresent
+
+# Directories potentially created on remote AFP share
+.AppleDB
+.AppleDesktop
+Network Trash Folder
+Temporary Items
+.apdisk
+
+### macOS Patch ###
+# iCloud generated files
+*.icloud
+
+### Node ###
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+.pnpm-debug.log*
+
+# Diagnostic reports (https://nodejs.org/api/report.html)
+report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+*.lcov
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# Snowpack dependency directory (https://snowpack.dev/)
+web_modules/
+
+# TypeScript cache
+*.tsbuildinfo
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Optional stylelint cache
+.stylelintcache
+
+# Microbundle cache
+.rpt2_cache/
+.rts2_cache_cjs/
+.rts2_cache_es/
+.rts2_cache_umd/
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variable files
+.env.development.local
+.env.test.local
+.env.production.local
+.env.local
+
+# parcel-bundler cache (https://parceljs.org/)
+.cache
+.parcel-cache
+
+# Next.js build output
+.next
+out
+
+# Nuxt.js build / generate output
+.nuxt
+dist
+
+# Gatsby files
+.cache/
+
+# vuepress build output
+.vuepress/dist
+
+# vuepress v2.x temp and cache directory
+.temp
+
+# Docusaurus cache and generated files
+.docusaurus
+
+# Serverless directories
+.serverless/
+
+# FuseBox cache
+.fusebox/
+
+# DynamoDB Local files
+.dynamodb/
+
+# TernJS port file
+.tern-port
+
+# Stores VSCode versions used for testing VSCode extensions
+.vscode-test
+
+# Yarn v4 (node-modules mode)
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/sdks
+!.yarn/versions
+.pnp.*
+
+### Node Patch ###
+# Serverless Webpack directories
+.webpack/
+
+# SvelteKit build / generate output
+.svelte-kit
+
+### Rails ###
+*.rbc
+capybara-*.html
+.rspec
+/db/*.sqlite3
+/db/*.sqlite3-journal
+/db/*.sqlite3-[0-9]*
+/public/system
+/coverage/
+/spec/tmp
+*.orig
+rerun.txt
+pickle-email-*.html
+
+# Ignore all logfiles and tempfiles.
+/log/*
+/tmp/*
+!/log/.keep
+!/tmp/.keep
+
+# TODO Comment out this rule if you are OK with secrets being uploaded to the repo
+config/initializers/secret_token.rb
+config/master.key
+
+# Only include if you have production secrets in this file, which is no longer a Rails default
+# config/secrets.yml
+
+# dotenv, dotenv-rails
+# TODO Comment out these rules if environment variables can be committed
+.env*.local
+
+## Environment normalization:
+/.bundle
+/vendor/bundle
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc
+
+# if using bower-rails ignore default bower_components path bower.json files
+/vendor/assets/bower_components
+*.bowerrc
+bower.json
+
+# Ignore pow environment settings
+.powenv
+
+# Ignore Byebug command history file.
+.byebug_history
+
+# Ignore precompiled javascript packs
+/public/packs
+/public/packs-test
+/public/assets
+
+# Ignore yarn files
+/yarn-error.log
+
+# Ignore uploaded files in development
+/storage/*
+!/storage/.keep
+/public/uploads
+
+### Ruby ###
+*.gem
+/.config
+/InstalledFiles
+/pkg/
+/spec/reports/
+/spec/examples.txt
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+*.bridgesupport
+build-iPhoneOS/
+build-iPhoneSimulator/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+/.bundle/
+/lib/bundler/man/
+
+### RubyMine ###
+.idea/**/workspace.xml
+.idea/**/tasks.xml
+.idea/**/usage.statistics.xml
+.idea/**/dictionaries
+.idea/**/shelf
+
+# AWS User-specific
+.idea/**/aws.xml
+
+# Generated files
+.idea/**/contentModel.xml
+
+# Sensitive or high-churn files
+.idea/**/dataSources/
+.idea/**/dataSources.ids
+.idea/**/dataSources.local.xml
+.idea/**/sqlDataSources.xml
+.idea/**/dynamic.xml
+.idea/**/uiDesigner.xml
+
+# Gradle
+.idea/**/gradle.xml
+.idea/**/libraries
+
+# CMake
+cmake-build-*/
+
+# Mongo Explorer plugin
+.idea/**/mongoSettings.xml
+
+# File-based project format
+*.iws
+
+# IntelliJ
+out/
+
+# mpeltonen/sbt-idea plugin
+.idea_modules/
+
+# JIRA plugin
+atlassian-ide-plugin.xml
+
+# Cursive Clojure plugin
+.idea/replstate.xml
+
+# SonarLint plugin
+.idea/sonarlint/
+
+# Crashlytics plugin (for Android Studio and IntelliJ)
+com_crashlytics_export_strings.xml
+crashlytics.properties
+crashlytics-build.properties
+fabric.properties
+
+# Editor-based Rest Client
+.idea/httpRequests
+
+# Android studio 3.1+ serialized cache file
+.idea/caches/build_file_checksums.ser
+
+### RubyMine Patch ###
+.idea/**/sonarlint/
+.idea/**/sonarIssues.xml
+.idea/**/markdown-navigator.xml
+.idea/**/markdown-navigator-enh.xml
+.idea/**/markdown-navigator/
+.idea/$CACHE_FILE$
+.idea/codestream.xml
+.idea/**/azureSettings.xml
+
+### Sass ###
+.sass-cache/
+*.css.map
+*.sass.map
+*.scss.map
+
+### VisualStudioCode ###
+.vscode/*
+!.vscode/settings.json
+!.vscode/tasks.json
+!.vscode/launch.json
+!.vscode/extensions.json
+!.vscode/*.code-snippets
+
+# Local History for Visual Studio Code
+.history/
+
+# Built Visual Studio Code Extensions
+*.vsix
+
+### VisualStudioCode Patch ###
+.history
+.ionide
+
+### Windows ###
+# Windows thumbnail cache files
+Thumbs.db
+Thumbs.db:encryptable
+ehthumbs.db
+ehthumbs_vista.db
+
+# Dump file
+*.stackdump
+
+# Folder config file
+[Dd]esktop.ini
+
+# Recycle Bin used on file shares
+$RECYCLE.BIN/
+
+# Windows Installer files
+*.cab
+*.msi
+*.msix
+*.msm
+*.msp
+
+# Windows shortcuts
+*.lnk

data/lib/better_app_gen/templates/root/yarnrc.yml.erb

@@ -0,0 +1,6 @@
+# Yarn 4 Configuration
+# Use node-modules linker for compatibility (NOT Plug'n'Play)
+nodeLinker: node-modules
+
+# Disable telemetry
+enableTelemetry: false

data/lib/better_app_gen/templates/script/dc-attach.erb

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+# Attach to a service's TTY for debugging
+# Usage: script/dc-attach [service_name]
+# Default: puma
+set -e
+
+SERVICE=${1:-puma}
+
+echo "Attaching to $SERVICE container..."
+echo "Use Ctrl+P Ctrl+Q to detach without stopping"
+echo "Use Ctrl+C to send interrupt signal (for debugger)"
+
+docker compose attach $SERVICE

data/lib/better_app_gen/templates/script/dc-build.erb

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+# Rebuild Docker images
+set -e
+
+echo "Building Docker images..."
+docker compose build
+
+echo "Docker images built successfully!"

data/lib/better_app_gen/templates/script/dc-down.erb

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+# Stop and remove containers
+set -e
+
+echo "Stopping services..."
+docker compose down
+
+echo "Services stopped successfully!"

data/lib/better_app_gen/templates/script/dc-logs-tail.erb

@@ -0,0 +1,16 @@
+#!/usr/bin/env bash
+# Show last N lines of logs
+# Usage: script/dc-logs-tail [service_name] [lines]
+# Default: 100 lines from all services
+set -e
+
+SERVICE=$1
+LINES=${2:-100}
+
+if [ -z "$SERVICE" ]; then
+  echo "Showing last $LINES lines from all services..."
+  docker compose logs --tail=$LINES
+else
+  echo "Showing last $LINES lines from $SERVICE..."
+  docker compose logs --tail=$LINES $SERVICE
+fi

data/lib/better_app_gen/templates/script/dc-logs.erb

@@ -0,0 +1,17 @@
+#!/usr/bin/env bash
+# Follow logs from services
+# Usage: script/dc-logs [service_name]
+# If no service specified, shows logs from all services
+set -e
+
+SERVICE=$1
+
+if [ -z "$SERVICE" ]; then
+  echo "Following logs from all services..."
+  echo "Press Ctrl+C to exit"
+  docker compose logs -f
+else
+  echo "Following logs from $SERVICE..."
+  echo "Press Ctrl+C to exit"
+  docker compose logs -f $SERVICE
+fi

data/lib/better_app_gen/templates/script/dc-rails.erb

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+# Open Rails console in a new container
+set -e
+
+echo "Opening Rails console..."
+echo "Type 'exit' to leave the console"
+
+docker compose run --rm puma bin/rails console

data/lib/better_app_gen/templates/script/dc-restart.erb

@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+# Restart all services
+set -e
+
+echo "Restarting services..."
+docker compose down
+docker compose up -d
+
+echo "Services restarted successfully!"
+echo "Rails app: http://localhost:<%= rails_port %>"
+echo "Vite HMR: http://localhost:<%= vite_port %>"

data/lib/better_app_gen/templates/script/dc-shell.erb

@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+# Open a bash shell in a container using docker compose run
+# Usage: script/dc-shell [service_name]
+# Default: puma
+set -e
+
+SERVICE=${1:-puma}
+
+echo "Opening bash shell in $SERVICE container..."
+echo "Type 'exit' to leave the shell"
+
+docker compose run --rm $SERVICE bash

data/lib/better_app_gen/templates/script/dc-up.erb

@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+# Start all services in detached mode
+set -e
+
+echo "Starting services..."
+docker compose up -d
+
+echo "Services started successfully!"
+echo "View logs with: script/dc-logs"
+echo "Rails app: http://localhost:<%= rails_port %>"
+echo "Vite HMR: http://localhost:<%= vite_port %>"

data/lib/better_app_gen/templates/vite/application.css.erb

@@ -0,0 +1,12 @@
+@import "tailwindcss";
+
+/* Source paths for class detection (replaces content array from tailwind.config.js) */
+@source "../../../views/**/*.html.erb";
+@source "../../helpers/**/*.rb";
+@source "../javascripts/**/*.js";
+
+/* Theme customization (replaces tailwind.config.js theme.extend) */
+@theme {
+  /* Add custom theme values here */
+  /* Example: --color-primary: oklch(0.7 0.15 200); */
+}

data/lib/better_app_gen/templates/vite/application.js.erb

@@ -0,0 +1,6 @@
+// Entry point for the build script in your package.json
+import "@hotwired/turbo-rails";
+import "./controllers";
+import "../assets/stylesheets/application.css";
+
+console.log("Vite initialized");

data/lib/better_app_gen/templates/vite/controllers/application.js.erb

@@ -0,0 +1,9 @@
+import { Application } from "@hotwired/stimulus"
+
+const application = Application.start()
+
+// Configure Stimulus development experience
+application.debug = false
+window.Stimulus   = application
+
+export { application }

data/lib/better_app_gen/templates/vite/controllers/hello_controller.js.erb

@@ -0,0 +1,7 @@
+import { Controller } from "@hotwired/stimulus"
+
+export default class extends Controller {
+  connect() {
+    this.element.textContent = "Hello World!"
+  }
+}

data/lib/better_app_gen/templates/vite/controllers/index.js.erb

@@ -0,0 +1,8 @@
+// This file is auto-generated by ./bin/rails stimulus:manifest:update
+// Run that command whenever you add a new controller or create them with
+// ./bin/rails generate stimulus controllerName
+
+import { application } from "./application"
+
+import HelloController from "./hello_controller"
+application.register("hello", HelloController)

data/lib/better_app_gen/templates/vite/postcss.config.js.erb

@@ -0,0 +1,5 @@
+export default {
+  plugins: {
+    "@tailwindcss/postcss": {},
+  },
+}

data/lib/better_app_gen/templates/vite/vite.config.js.erb

@@ -0,0 +1,48 @@
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { defineConfig } from "vite";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+export default defineConfig({
+  publicDir: false, // avoid conflicts with outDir
+  emptyOutDir: true,
+  css: {
+    devSourcemap: true,
+  },
+
+  server: {
+    port: <%= vite_port %>,
+    host: "0.0.0.0",
+    cors: true,
+    hmr: {
+      port: <%= vite_port %>,
+    },
+  },
+
+  build: {
+    outDir: "public/assets",
+    manifest: true,
+    sourcemap: true,
+    emptyOutDir: true,
+
+    rollupOptions: {
+      input: {
+        application: resolve(
+          __dirname,
+          "app/javascript/application.js"
+        ),
+      },
+      output: {
+        entryFileNames: "application-[hash].js",
+        assetFileNames: (info) => {
+          if (info.name?.endsWith(".css")) {
+            return "application-[hash][extname]";
+          }
+          return "[name]-[hash][extname]";
+        },
+      },
+      external: [],
+    },
+  },
+});

data/lib/better_app_gen/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module BetterAppGen
+  VERSION = "0.1.0"
+end

data/lib/better_app_gen.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require_relative "better_app_gen/version"
+require_relative "better_app_gen/errors"
+require_relative "better_app_gen/configuration"
+require_relative "better_app_gen/dependency_checker"
+require_relative "better_app_gen/generators/base"
+require_relative "better_app_gen/app_generator"
+require_relative "better_app_gen/cli"
+
+module BetterAppGen
+  class << self
+    # Returns the root path of the gem
+    def root
+      @root ||= Pathname.new(File.expand_path("..", __dir__))
+    end
+
+    # Returns the path to the templates directory
+    def templates_path
+      @templates_path ||= root.join("lib", "better_app_gen", "templates")
+    end
+  end
+end