Skip to content

trees-and-airlines/MapGenerator

 
 

Repository files navigation


Logo

Map Generator

Create procedural American-style cities
Open Generator »

Read the Docs · Report Bug · Request Feature

Table of Contents

About The Project

Map Generator Screen Shot

This tool procedurally generates images of city maps. The process can be automated, or controlled at each stage give you finer control over the output. Generated cities can be downloaded as a .png or an .svg. There are a few choices for drawing style, ranging from colour themes similar to Google or Apple maps, to a hand-drawn sketch.

Built With

Getting Started

To get a local copy up and running follow these steps.

Prerequisites

  • npm
npm install npm@latest -g
  • Gulp
npm install --global gulp-cli

Installation

  1. Clone the mapgenerator
git clone https://github.com/probabletrain/mapgenerator.git
  1. Install NPM packages
cd mapgenerator
npm install
  1. Add this line to node_modules/@svgdotjs/svg.js/package.json
"browserify": {
  "transform": [["babelify", { "presets": ["@babel/preset-env"] }]]
},
  1. Build with Gulp. This will watch for changes to any Typescript files. If you edit the HTML or CSS you will have to rerun this command. Gulp Notify sends a notification whenever a build finishes.
gulp
  1. Open dist/index.html in a web browser, refresh the page whenever the project is rebuilt.

Usage

See the documentation.

Roadmap

See the open issues for a list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated. For major changes, please open an issue first to discuss what you would like to change.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License

Distributed under the GPL-3.0 License. See LICENSE for more information.

Contact

Keir - @probabletrain - probabletrain@gmail.com

Project Link: https://github.com/probabletrain/mapgenerator

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 98.5%
  • Other 1.5%