Do not rely on Asset Pipeline about apitome

[swapnilchincholkar]

Simply using the generator didn't work for me for rails.6 API only app.

1. After using the generator
2. I changed configs from config/initializers/apitome.rb as
   config.css_override = "/stylesheets/apitome/application.css"
   and
   config.js_override = "/javascripts/apitome/application.js"
3. Manually copied theme file from gem's code to public/stylesheets/apitome/

That also gave issue post deployments hence at last
a. overridden then layout (i.e copied from gem to application) at "app/views/layouts/apitome.rb" with default css to refer as
<%= stylesheet_link_tag "/stylesheets/apitome/default.css", media: "all" %>

b. changed config file as
config.layout = "apitome"

That worked perfectly post-deployment too. Hope it helps someone too.

[jejacks0n]

That's reasonable.. where would the assets get moved to? /public? Do people even serve static files usually with rails-api?

[jejacks0n]

And then, if we don't use the asset pipeline, how do people override easily? It might take some playing. Could you not just use sprockets-rails with rails-api and have the same result?

[Spone]

For now, I switched to ActionController::Metal instead of rails-api, so I can include the needed modules.
I think using the default assets statically with Apitome could be enough (or hosting them separately on a CDN / static server). I didn't need to override the assets.

[jejacks0n]

Right, you may not need to override the assets for now, but it's nice to have the possibility, and is a core aspect of the project. I can play around and see if this is possible.

[jejacks0n]

well, after poking around.. you'd have to copy the files into your own project, since there's no way to serve "public" assets from a gem. so I guess a generator to install the assets is about as good as it gets.

[Spone]

Great! I'll keep an eye on this, let me know if I can be of some help 😃

EDIT: a generator would be totally fine for this specific use case!

[jejacks0n]

let me know how that goes.

[Spone]

I think the generator should copy the files to the following paths:

public/stylesheets/apitome/application.css
public/javascripts/apitome/application.js

in order to work with the following settings:

config.css_override = 'apitome/application.css'
config.js_override = 'apitome/application.js'

[jejacks0n]

you shouldn't have to configure anything.. just install them.

[Spone]

Well, if I do not configure anything, here is what I have in the documentation HTML :

<link href="/stylesheets/apitome/application.css" media="all" rel="stylesheet" />
<script src="/javascripts/apitome/application.js"></script>

I think it's because I don't use Sprockets.

This config works, though:

config.css_override = '/assets/apitome/application.css'
config.js_override = '/assets/apitome/application.js'

[jejacks0n]

Ah, right.. right, so sprockets must take over javascript_include_tag and stylesheet_link_tag methods.. makes sense. so the generator should put them in public/javascripts/apitome etc.?

[jejacks0n]

I just made an update to this, tell me if it works better.

[Spone]

Yes it's working 👍 Thanks!

[samnang]

@jejacks0n I'm using rails-api, currently I copy the files manually. How do I run either rake task or generator to copy assets files from my project?

[chrishough]

This does appear to be working but should there be a task to gen those files? I had to generate them with the asset pipeline turned on, than rename them.

[jejacks0n]

https://github.com/modeset/apitome/blob/master/lib/generators/apitome/install/install_generator.rb

[chrishough]

@jejacks0n ahh, thanks 😸