Improve setup instructions #8545

tagliala · 2024-11-17T10 8000 :00:16Z

Separates database setup from server startup and clarifies asset handling.
Copy cssbundling-rails instructions from Upgrading guide as a recommended approach for managing Tailwind CSS assets
Suggest to start the server with bin/dev to handle both web and CSS building processes.

[ci skip]

- Separate database setup from server startup and clarifies asset handling process - Copy `cssbundling-rails` instructions from the Upgrading guide as a recommended approach for managing Tailwind CSS assets - Suggest starting the server with `bin/dev` to handle both web and CSS building process Ref: #8538 [ci skip]

PoroshkinaVV · 2024-11-22T21:36:06Z

docs/0-installation.md

+  rails importmap:install
+
+  bundle add cssbundling-rails
+  rails css:install:tailwind


It's not necessary to install tailwind. One can run command rails css:install and it should work.

I mean, gem 'tailwindcss-rails' may not be installed

PoroshkinaVV · 2024-11-22T21:36:55Z

docs/0-installation.md

+
+  ```sh
+  bundle add importmap-rails
+  rails importmap:install


As far as I know from my upgrade experience - it's also not necessary.

rails importmap:install is not necessary because it is being performed by rails g active_admin:install

PoroshkinaVV · 2024-11-22T21:39:03Z

docs/0-installation.md

+
+  ```sh
+  bin/dev
+  ```


I think for those who doesn't have Procfile.dev you should give another option:

yarn build:css rails s

andrewroth · 2024-11-26T07:17:06Z

Hi,

I'm starting a new rails 8 app with active admin, and the styles didn't load at all, after following the basic guide.

After some searching I came across this, and followed the commands, but I get 02:15:57 css.1 | Specified input file ./app/assets/stylesheets/active_admin.css does not exist. -- any ideas?

Should I just go back to rails 7 for now and accept rails 8 and active admin are incompatible (is this actually the case)? Thanks.

tagliala · 2024-11-26T07:57:41Z

Should I just go back to rails 7 for now and accept rails 8 and active admin are incompatible (is this actually the case)?

They are compatible:

#8538 (reply in thread)

If you have some sort of edge cases, or different instructions, please provide more information so we can improve the installation guide

edit: guide updated and tested again, I confirm that Rails 8.0 and Active Admin 4 beta are compatible

andrewroth · 2024-11-26T08:34:34Z

I still have no css after hours of effort.

If I run npx tailwindcss -i ./app/assets/stylesheets/active_admin.css -o ./app/assets/builds/active_admin.css --minify -c tailwind-active_admin.config.js manually, I get:

Rebuilding...
Error: Cannot find module 'tailwindcss/plugin'
Require stack:
...
 {
  code: 'MODULE_NOT_FOUND',
  requireStack: [
    '/Users/andrew/Development/node_modules/@activeadmin/activeadmin/plugin.js'
  ]
}

I've googled "Error: Cannot find module 'tailwindcss/plugin'" and tried every possible fix I can find with no success.

andrewroth · 2024-11-26T08:51:07Z

Is it possible to use active admin without tailwind?

tagliala · 2024-11-26T09:08:10Z

Can you please provide the list of commands that you are executing?

Also please include Ruby and Node versions

ruby --version
# ruby 3.3.6 (2024-11-05 revision 75015d4c1f) [x86_64-darwin24]

node --version
# v20.18.1

rails _8.0.0_ new my_app
cd my_app
bundle add activeadmin -v=4.0.0beta14
bundle add devise
rails g active_admin:install
bundle add cssbundling-rails
rails css:install:tailwind
rails db:migrate
rails db:seed
yarn add @activeadmin/activeadmin@4.0.0-beta14
npm pkg set scripts.build:css="tailwindcss -i ./app/assets/stylesheets/active_admin.css -o ./app/assets/builds/active_admin.css --minify -c tailwind-active_admin.config.js"

Is it possible to use active admin without tailwind?

Can't tell, maybe there are infos here: #8223

andrewroth · 2024-11-26T09:15:41Z

I am on an old node and osx, maybe that has something to do with it?

node --version
v16.16.0

ruby --version
ruby 3.3.6 (2024-11-05 revision 75015d4c1f) [x86_64-darwin17]

tagliala · 2024-11-26T09:25:05Z

node --version
v16.16.0

This may be an issue, but we are not aware of such issue.

I remember that I couldn't update to v4 with Node 16, but I need to check why

tagliala · 2024-11-26T09:38:47Z

I'm successfully running the application with node 16.20.2

andrewroth · 2024-11-26T10:11:07Z

That did get further, staring from a new app from scratch.

Now I get this:

tagliala · 2024-11-27T16:22:17Z

looks like assets are not being build

Can you try ./bin/dev instead of rails s and report any error in the asset building?

renatoaug · 2025-01-09T22:05:18Z

That did get further, staring from a new app from scratch.

Now I get this:

I am with this same problem here.

I ran using ./bin/dev and the result was:

tagliala · 2025-01-09T22:14:30Z

Hi,

These are the instructions to create an app from scratch

SuperAdmin::CompaniesController looks like existing code

renatoaug · 2025-01-10T12:01:51Z

Hi,

These are the instructions to create an app from scratch

SuperAdmin::CompaniesController looks like existing code

Hi @tagliala ,

I was talking about the broken layout:

I followed all the steps here https://github.com/activeadmin/activeadmin/blob/master/UPGRADING.md to upgrade from v3 to v4 but I think the css is not being applied.

teaforthecat · 2025-01-26T12:39:22Z

Hi, just want to point out that this is a reasonable alternative to cssbundler if the goals are these:

ActiveAdmin 3
Rails 8 (with or without tailwind)
Not requiring node

bundle add dartsass-rails
echo "Rails.application.config.dartsass.builds = {\n  'active_admin.scss' => 'active_admin.css'\n}" > config/initializers/dartsass.rb
echo "sass: bin/rails dartsass:watch" >> Procfile.dev
bin/dev

I wonder if this could go into the activeadmin:install task just for the time between Rails 8 being out and ActiveAdmin 4 not yet out?

thisismydesign · 2025-04-22T17:10:26Z

docs/0-installation.md

+it works effectively.
+
+If you haven't installed and configured `cssbundling-rails` and
+`importmap-rails`, please run:


Yes this is necessary, but their setup might change. It's easiest to just say install and configure cssbundling-rails and importmap-rails

tagliala force-pushed the chore/fix-installation-guide branch 4 times, most recently from 024db0e to 8b381a9 Compare November 17, 2024 10:22

tagliala force-pushed the chore/fix-installation-guide branch from 8b381a9 to ae6eeba Compare November 17, 2024 10:22

PoroshkinaVV reviewed Nov 22, 2024

View reviewed changes

tagliala mentioned this pull request Dec 2, 2024

active_admin.scss generated even when no SASS support is present #8562

Closed

tagliala mentioned this pull request Jan 29, 2025

Feature: Tailwind 4 compatibility #8615

Closed

1 task

thisismydesign reviewed Apr 22, 2025

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Improve setup instructions #8545

Improve setup instructions #8545

Improve setup instructions #8545

Are you sure you want to change the base?

Improve setup instructions #8545

Conversation

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment