react-bubbly-transitions

Show bubbly transitions between route changes, in your React 18 apps.

Click here for a demo.

Or check out the npm package here.

Installation

Just a few quick steps to get started:

1. Create a React app (optional)

If you are adding the transitions to an existing app, you can skip this step.

npx create-react-app my-bubbly-app
cd my-bubbly-app

2. Install dependencies

Our project depends upon React's router library

npm i react-bubbly-transitions react-router-dom

3. Add components

The package relies on two components being present.

BubblyContainer

This is what houses our wave transition between route changes and does not require any props.

BubblyLink

This button can be declared anywhere inside your Router component.

It takes the following props:

| Prop | Description | Example | type | required | default | | ---------- | -------------------------------------------------------------------------------------------- | ------- | ------------------ | -------- | ------- | | children | The content inside the link | About | String / Component | true | | | to | The route that the link will take you to | /about | String | true | | | colorStart | The background color of the bubble shape that appears first. Must be a hexcode or rgba value | #8f44fd | String | false | #8f44fd | | colorEnd | The background color of the bubble shape that appears last. Must be a hexcode or rgba value | #ffffff | String | false | #ffffff |

Be careful with the duration (too fast/slow can ruin the effect) - my recommended duration is between 1000ms and 1600ms.

Example App.tsx

Copy this whole code snippet into your App.tsx for a basic example:

import { BrowserRouter, Routes, Route, Outlet } from "react-router-dom";

import { BubblyContainer, BubblyLink } from "react-bubbly-transitions";

const Home = () => <div>Home</div>;
const About = () => <div>About</div>;
const Contact = () => <div>Contact</div>;

function App() {
  return (
    <BrowserRouter>
      <BubblyContainer />
      <Routes>
        <Route
          path="/"
          element={
            <>
              <BubblyLink to="/">Home</BubblyLink>
              <BubblyLink to="/about">About</BubblyLink>
              <BubblyLink to="/contact">Contact</BubblyLink>
              <Outlet />
            </>
          }
        >
          <Route index element={<Home />} />
          <Route path="about" element={<About />} />
          <Route path="contact" element={<Contact />} />
          <Route path="*" element={<>No Match</>} />
        </Route>
      </Routes>
    </BrowserRouter>
  );
}

export default App;

4. Styling

To style the BubblyLink component you can target it via css (just be more specific than me 😄):

body .react-bubbly-transitions__bubbly-link {
  color: #af44fd;
}

To style the active state of the BubblyLink, just target the .active class and again be more specific.

body .react-bubbly-transitions__bubbly-link.active {
  text-decoration: underline;
}

5. DRY (Don't Repeat Yourself)

To avoid repeating certain BubblyLink props, I recommend creating your own generic link component that sets the props here by default.

import { FC, ReactNode } from "react";
import { BubblyLink } from "react-bubbly-transitions";

type Props = {
  to: string;
  children: ReactNode;
};

export const MyBubblyLink: FC<Props> = ({ to, children }) => (
  <BubblyLink colorStart="#af44fd" colorEnd="#222222">
    {children}
  </BubblyLink>
);

6. Have fun with it!

Please hit me up on My Instagram page for any support or suggestions 🙂