rostaklein / Mayoor
Programming Languages
Projects that are alternatives of or similar to Mayoor
Modern order management system built with the latest tech stack.
Whats included? 🚀
- orders + customers CRUD
- forms, lists
- validations
- frontend localization
- deployment setup
- end to end tests
Tech stack
- TypeScript
- React
- GraphQL
- Prisma (latest version 2)
- NexusJS
- Apollo Server, Apollo Client
- Formik
- styled-components
- Ant design
- ESLint
Live app demo
🌍 Visit http://mayoor.herokuapp.com/ - and log in with username: admin
, password: admin
Screenshots
Why does it exist?
The main motivation is to provide a codebase for an order management system that you can build on top of.
This project was built with a main focus as a support software for a company that prints PVC banners etc. Thats the reason why you might find some business specific pieces of code. The company is based in Czechia 🇨🇿, thats also the reason why the default currency is CZK and there are Czech translations.
Also this project is a result of my masters thesis on the University of Economics in 2020 👨🎓
Requirements
- Node.js v12 (includes NPM)
- Git
- (optional, see below) Docker Desktop
You will need to provide a PostgreSQL database URL to have this app running. It is pretty much up to you where do you want to host this database. The recommended way is to spin it up using Docker. To do so:
- install Docker Desktop (follow all the steps there, restart might be required)
- run
make dev-db
(works on MacOS and Linux), or manually by (for Windows):docker-compose -f docker-compose.dev-db.yml up -d
- the database is now up and running as deamon (the
-d
flag), you can verify this by runningdocker ps -a | grep 54320
(check that postgres is running) - check that the database is running by logging into Adminer http://localhost:8089/?pgsql=db&username=mayoor-user&db=mayoor-db password is
developer1
Later on, you can turn off the docker deamon by running:
docker-compose -f docker-compose.dev-db.yml down
(in the root folder of this project)
If you dont want to use Docker, you can use a remote hosted database for dev env as well (not recommended, though!). Free plans for postgre e.g. here - https://www.elephantsql.com/ are ok for this kind of app. You will need to provide the connection URL to the ENV variables in backend setup.
Getting started
To get the up and running in development mode, you need to follow these two:
Clone this repository:
git clone https://github.com/rostaklein/mayoor
🏃♂️Get both parts running:
License
MIT
Rostislav Klein - mayoor - manage your orders - 2020