Repolode
dimartarmizi

dimartarmizi/map-to-poster

A client-side web app that turns any searched location into a customizable, high-resolution map poster with themes, layouts and PNG export.

Open-source alternative to:Positive Grid PosterMapiful

Stars
1,097
Forks
168
Open issues
5
Last commit
5 months ago

What is it?

MapToPoster JS lets you search for any place in the world and turn it into a printable map poster. You can choose between raster themes rendered with Leaflet, such as Minimal White, Midnight Dark and Satellite View, and vector artistic themes rendered with MapLibre GL, such as Arctic Frost and Blueprint Classic.

The editor covers layout as well as styling. You can add and drag markers, plot travel routes using OSRM routing, add a mat or passepartout frame, toggle country names, coordinates and labels, and draggable city-label overlays. Settings persist in LocalStorage.

Exports are PNG files at custom resolutions, up to 50,000px. Everything runs in the browser, so location data is not sent to a server. The project is built with Vite and Tailwind CSS and includes a Docker setup that serves the static build with Nginx.

Key features

  • 01Search any global location via Nominatim geocoding.
  • 02Switch between Leaflet raster themes and MapLibre GL vector artistic themes.
  • 03Add, drag and style multiple markers.
  • 04Plot travel routes with OSRM-based path fetching.
  • 05Add a mat frame with adjustable width, border and opacity.
  • 06Export PNG files up to 50,000px.
  • 07Runs entirely in the browser with settings saved to LocalStorage.

Use cases

  • Creating a poster of a hometown, city or travel route as wall art.
  • Making personalized map gifts for weddings, anniversaries or relocations.
  • Producing large-format prints from a self-hosted static deployment.

Quick start

  1. 1

    Clone the repository

    git clone https://github.com/dimartarmizi/map-to-poster.git
  2. 2

    Enter the project folder

    cd map-to-poster
  3. 3

    Install dependencies

    npm install
  4. 4

    Start the development server (opens at http://localhost:5173)

    npm run dev

Things to know

  • Requires Node.js 18.0.0 or higher to run locally.
  • Map tiles and search depend on third-party services such as Nominatim, OSRM and CartoDB.

Topics

FAQ

What is map-to-poster?
A client-side web app that turns any searched location into a customizable, high-resolution map poster with themes, layouts and PNG export. MapToPoster JS lets you search for any place in the world and turn it into a printable map poster. You can choose between raster themes rendered with Leaflet, such as Minimal White, Midnight Dark and Satellite View, and vector artistic themes rendered with MapLibre GL, such as Arctic Frost and Blueprint Classic.
Is map-to-poster free to use? What license does it have?
map-to-poster is open source under the MIT license. Check the license terms before using it in commercial products.
Is map-to-poster still maintained?
Updated within 6 months. The last commit to map-to-poster was on Jun 6, 2026.
What can I use map-to-poster for?
Creating a poster of a hometown, city or travel route as wall art. Making personalized map gifts for weddings, anniversaries or relocations. Producing large-format prints from a self-hosted static deployment.
How do I install map-to-poster?
Clone the repository: git clone https://github.com/dimartarmizi/map-to-poster.git Enter the project folder: cd map-to-poster Install dependencies: npm install Start the development server (opens at http://localhost:5173): npm run dev
Where can I get map-to-poster?
The source code and installation instructions are on GitHub: https://github.com/dimartarmizi/map-to-poster

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects