Need help with react-hexgrid?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.


Build interactive hexagon grids with React

149 Stars 57 Forks MIT License 122 Commits 25 Opened issues

Services available

Need anything else?


build status Downloads npm version dependencies Status devDependencies Status Live demo License

React components to build interactive hexagons grids. It uses SVG which makes it fast, scalable and easy to apply custom styles. You can easily customize the layout of the grid just by configuration.

Component-based approach allows you to customize the grid shape to suit your needs or even apply your own components / SVG elements to it. You can use pre-defined generator to create certain shape grid or you may build totally your own grid to the shape you wish, while still keeping it under control and interactive.

You could easily use this library to build (just to name a few) a nice portfolio, image library or even a game!

With inspiration from


You should be familiar with Node + NPM, React and ES6 to use this library. Library also depends heavily on HTML5 features (mostly SVG) which all might not be supported by every browser yet. For example Drag & Drop is still quite heavily under work.

Getting Started

Install it via npm:

npm install --save react-hexgrid

More documentation in the Wiki.


import { HexGrid, Layout, Hexagon, Text, Pattern, Path, Hex } from 'react-hexgrid';
import './App.css';

class App extends Component { render() { return (

{/* Grid with manually inserted hexagons /} {/ Using pattern (defined below) to fill the hexagon /} 1, -1, 0 1, 0, -1 {/ Pattern and text */} -1, 1, 0
); } }

Will look something like this (custom CSS applied): HexGrid image


See examples folder.


  1. basic-board - Basic usage of react-hexgrid
  2. custom-grid - Simple custom grid
  3. templates - Ready-made grid templates


  1. pathfinding - Pathfinding
  2. drag & drop - Drag & drop with two grids
  3. animations - Animations & effects

Testing changes locally

You can test changes by importing the library directly from a folder:

  1. Do changes to the library
  2. On your test project:
    npm install /path/to/your/react-hexgrid/ --save
  3. For easy development, you can
    npm link react-hexgrid
    on your application
  4. And finally
    npm run compile
    the react-hexgrid to have the changes in your application



We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.