Remove Tailwind, implement plain CSS design system #10
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Type
Feature
Lineage
Standalone — discovered during production validation. Tailwind CSS build is broken in production (4.5KB output, all utility classes purged). Decided to replace with plain CSS rather than fix the Tailwind v4 content scanner.
Repo
ldraney/pal-enterprisesUser Story
As a visitor or authenticated user
I want the site to render with proper styling
So that the landing page, login, and dashboard are usable and professional
Context
The
tailwindcss-railsgem uses Tailwind v4 with automatic content detection (@import "tailwindcss"). During the Docker production build,assets:precompileruns the Tailwind scanner, but it fails to find ERB templates — producing a 4.5KB CSS file with only the base reset and ~10 utility classes. The HTML references ~30 unique Tailwind class combinations (bg-gray-50,text-indigo-600,shadow,max-w-5xl, etc.), none of which survive to production.Rather than debug the Tailwind build pipeline, we're switching to plain CSS following the pal-e-playground design system adapted for Rails in the ror-css-guide. This eliminates the build step entirely — Propshaft serves static CSS with no compilation.
File Targets
Files the agent should modify or create:
Gemfile— removetailwindcss-railsapp/assets/stylesheets/application.css— full design system (tokens, reset, layout, components)app/views/layouts/application.html.erb— remove Tailwind stylesheet link, update body/nav classesapp/views/pages/home.html.erb— replace Tailwind utility classes with semantic classesapp/views/contacts/new.html.erb— replace Tailwind utility classesapp/views/contacts/_form.html.erb— replace Tailwind utility classesapp/views/sessions/new.html.erb— replace Tailwind utility classesapp/views/dashboard/index.html.erb— replace Tailwind utility classesProcfile.dev— removecss: bin/rails tailwindcss:watchREADME.md— update stack tableFiles the agent should delete:
app/assets/tailwind/application.cssapp/assets/builds/tailwind.cssFiles the agent should NOT touch:
Dockerfile—assets:precompilestill runs, Propshaft handles static CSSconfig/— no initializer changes neededAcceptance Criteria
var(--token)— zero hardcoded hex outside:rootnoticeandalertTest Expectations
docker buildsucceeds and serves styled pagesdocker build -t pal-enterprises . && docker run --rm -p 3000:80 pal-enterprisesConstraints
--color-accent: #0366d6,--max-width: 48rem.form > .fieldpattern for forms, not classes on every inputChecklist
Related
pal-enterprises— project this affectsror-css-guide— CSS conventions referenceScope Review: NEEDS_REFINEMENT
Review note:
review-1188-2026-05-09Template is complete and all 12 file targets verified (10 to modify, 2 to delete). Traceability has one gap: the
arch:rails-applabel is used on 9 board items but has no backing architecture note in pal-e-docs.arch-rails-appfor the Rails application componentAll acceptance criteria are testable. No decomposition needed despite 10 file targets and 9 AC -- changes are tightly coupled (single atomic CSS framework swap). No blocking dependencies on the board.