Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 20 additions & 1 deletion src/app-pages/documentation/getting-started/adding-tailwind.jsx
Original file line number Diff line number Diff line change
Expand Up @@ -105,6 +105,26 @@ export default defineConfig({
<Code className="!gw-font-bold">./src/index.css</Code>
<CodeExample code={`@import "tailwindcss"`}></CodeExample>

<P>
Import the Groundwork stylesheet from your application entry point,
after <Code>index.css</Code>. This keeps Tailwind and Groundwork in
a predictable order.
</P>
<Code className="!gw-font-bold">./src/main.jsx</Code>
<CodeExample
code={`import React from "react";
import ReactDOM from "react-dom/client";
import App from "./App.jsx";
import "./index.css";
import "@usace/groundwork/groundwork.css";

ReactDOM.createRoot(document.getElementById("root")).render(
<React.StrictMode>
<App />
</React.StrictMode>
);`}
></CodeExample>

<P></P>
<Code className="!gw-font-bold">terminal</Code>
<CodeExample code={`npm run dev`}></CodeExample>
Expand All @@ -113,7 +133,6 @@ export default defineConfig({
<Code className="!gw-font-bold">./src/App.jsx</Code>
<CodeExample
code={`import { SiteWrapper, Container, UsaceBox } from "@usace/groundwork";
import "@usace/groundwork/dist/groundwork.css";

function App() {
return (
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -370,6 +370,7 @@ import getStore from "./app-bundles";
import { ReduxBundlerProvider } from "redux-bundler-hook";
import App from "./App.jsx";
import "./index.css";
import "@usace/groundwork/groundwork.css";

const store = getStore();

Expand Down Expand Up @@ -400,7 +401,6 @@ ReactDOM.createRoot(document.getElementById("root")).render(
<CodeExample
code={`import { useConnect } from "redux-bundler-hook";
import { SiteWrapper, Container } from "@usace/groundwork";
import "@usace/groundwork/dist/groundwork.css";

function App() {
const { route: Route } = useConnect("selectRoute");
Expand Down Expand Up @@ -453,7 +453,6 @@ export default App;`}
code={`import { useConnect } from "redux-bundler-hook";
import { getNavHelper } from "internal-nav-helper";
import { SiteWrapper, Container } from "@usace/groundwork";
import "@usace/groundwork/dist/groundwork.css";

function App() {
const { route: Route, doUpdateUrl } = useConnect(
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -151,14 +151,33 @@ npm run dev`}
file, delete everything here, we don't want these styles colliding
with what we're doing.
</P>
<P>
Open <Code className="gw-text-nowrap">./src/main.jsx</Code> and
import the Groundwork stylesheet after your application stylesheet.
Keeping both imports in the entry point makes their order explicit
and ensures Groundwork component styles are applied last.
</P>
<Code className="!gw-font-bold">./src/main.jsx</Code>
<CodeExample
code={`import React from "react";
import ReactDOM from "react-dom/client";
import App from "./App.jsx";
import "./index.css";
import "@usace/groundwork/groundwork.css";

ReactDOM.createRoot(document.getElementById("root")).render(
<React.StrictMode>
<App />
</React.StrictMode>
);`}
/>
<P>
Open the <Code className="gw-text-nowrap">./src/App.jsx</Code> file.
We're going to replace the contents with the code block below:
</P>
<Code className="!gw-font-bold">./src/App.jsx</Code>
<CodeExample
code={`import { SiteWrapper, Container, UsaceBox } from "@usace/groundwork";
import "@usace/groundwork/dist/groundwork.css";

function App() {
return (
Expand Down
10 changes: 6 additions & 4 deletions src/app-pages/documentation/index.jsx
Original file line number Diff line number Diff line change
Expand Up @@ -69,13 +69,15 @@ function Docs() {
</div>
<div className="gw-flex gw-flex-row gw-justify-start gw-space-between gw-items-center gw-gap-2 gw-mt-3 gw-mb-3">
<Code className="gw-block gw-p-1 gw-px-2">
import "@usace/groundwork/dist/groundwork.css"
import "@usace/groundwork/groundwork.css"
</Code>
<CopyButton text={`import "@usace/groundwork/dist/groundwork.css"`} />
<CopyButton text={`import "@usace/groundwork/groundwork.css"`} />
</div>
<Text>
Make sure to import groundwork.css from Groundwork into your top-level
component (i.e. App.jsx), then go build stuff with the components
Import Groundwork CSS in your application entry point (for example,
main.jsx), after your application stylesheet. This keeps stylesheet
order predictable and prevents app-wide styles from overriding
Groundwork components.
</Text>

<H4 className="gw-mt-6">Contributing</H4>
Expand Down
Loading