Skip to content

Latest commit

 

History

History
50 lines (29 loc) · 5.01 KB

readme.md

File metadata and controls

50 lines (29 loc) · 5.01 KB

MasterPlan

MasterPlan is a customizeable graphical project management software for independent users or small teams.

If you need to share plans across a whole company on an online platform, there are quite a few tools for that. However, if you want to keep track of your todo list, version control your project plan, make an ideaboard, and plan your project your way, MasterPlan is the tool for you.

Note that this is the code repo and internal-ish issue tracker for MasterPlan. Releases can be purchased from itch or Steam. You can build it yourself from this repository if you're familiar with Go.

History

A few days before the initial commit to this repository, I was working on an indie game, and thought I needed a tool to help me plan out the rest of it. I asked on Twitter for some suggestions of software to try, and found that while they were solid choices, they weren't as applicable to independent development as I would have liked. Most project management software is designed for use by a large team, or even a large company. The disadvantages of many project management tools available today can be due to the features they offer, as they may not be applicable to small teams:

  1. They’re cloud-based, and generally web-focused. This being the case, they usually require using a web browser to view, and so can be relatively heavy applications.
  2. Because of point 1, they may not offer a downloadable copy of their software. Even if they do, they might require hosting a server that serves you the management pages, or might require owning an account to use the application.
  3. They can be more complex than necessary to use by offering features that, while useful for larger organizations, are unnecessary for small teams or individual developers (for example, permissions, users, issue assignment, etc). This increases bloat and friction when it comes to learning and using the software.
  4. The data you create in these tools may not easily be version controlled, as the data for your project management lies elsewhere from your source code.

While these features (cloud-based, browser apps, etc.) can be beneficial for large groups of developers, they can also become sticking points for individuals or small teams. So, I decided to make a tool myself to help independent developers plan out projects such as these. And so, the result is a simple, compiled, downloadable application that stores project data on your computer. The project plan file are plain JSON text files, and can be easily committed to a version control system. The goal for MasterPlan is to make a project management and visual planning tool that is easy to use and extremely simple. I believe it is reaching this goal.

Building

MasterPlan is not quite fully free software, but the source is available here. If you wish to build MasterPlan or contribute to its development, I thank you, and welcome it.

To this end, I've made a build script in Go to simplify the building process. In general, it's easier to try running MasterPlan first (go run ./ in the project root), and if that works, building should generally succeed. The build script is located at build_script\main.go. The dependencies for building should be resolved automatically by go mod (so you should be using a recent version of Go with support for go.mod files). Just run:

> go run ./build_script/main.go -b

from the MasterPlan source directory to build. It should generate a folder named bin, and populate it with a directory with a release build for your OS and architecture, by default.

If you follow the necessary steps for cross-compilation from go-sdl2's instructions, you can also specify a target OS to build MasterPlan for that OS.

> go run ./build_script/main.go -b -os windows/amd64

Requirements

All requirements for building and running MasterPlan should be filled by the go.mod and the building process automatically on all platforms.

Linux additionally requires the use of zenity, qarma, or matedialog for opening file selection windows, and a X11 dev package (libx11-dev, xorg-dev, or libX11-devel) for clipboard copy-and-paste functions.

License

MasterPlan is copyright, All Rights Reserved, SolarLune Games 2019-2021.

Feel free to use the program itself and the generated plan files in the development of projects, commercial or otherwise, as that's the point of the tool, haha. You can also build MasterPlan yourself using the repo here, contribute to its development, and fork it freely, but you may not use any assets (graphics files, sound files, code, etc) from this repository in any commercial creations. Please also do not distribute builds of MasterPlan to others.

Special thanks to raysan5 for creating Raylib, as it was pretty key to the development of MasterPlan, and works rather well! Also thanks to the SDL development team, and the go-sdl2 maintenance team!