The Mint System Frappe development environment.
Find a file
Janik von Rotz 4c7e98d799 Fix spacing
2021-09-13 18:08:54 +02:00
.gitignore frappe docker container 2021-05-18 21:15:42 +02:00
.gitmodules frappe docker container 2021-05-18 21:15:42 +02:00
docker-compose-dev.yml Change socketio default port 2021-09-13 16:57:54 +02:00
docker-compose.yml Restore old Docker Setup 2021-09-13 15:06:12 +02:00
README.md Separate commands 2021-09-13 17:04:40 +02:00
task Fix spacing 2021-09-13 18:08:54 +02:00
task.md Rename bench tasks 2021-09-13 17:35:18 +02:00

Frappe Development

The Mint System Frappe development environment.

This projects provides a highly opinionated way to develop Frappe sites and apps. It provides three ways to run Frappe.

  • Native: Frappe is downloaded to the project folder. Use bench natively to run the development server.
  • Docker Production: This approach uses Docker Compose to the setup a Frappe project as it would be running in production.
  • Docker Development: The production setup is complex. Use this approach run Frappe Bench within a container.

Requirements

Common:

  • bash/zsh alias task='./task' with optional completion

Docker:

Native:

  • Install Python 3.6+ with pyenv
  • Install Node.js 12+ with n
  • Install yarn 1.12+: npm install -g yarn
  • wkhtmltopdf: sudo apt install wkhtmltopdf

Usage

Clone this repository.

git clone https://github.com/Mint-System/Frappe-Development.git
cd Frappe-Development

See command overivew with task help or read task.

Check if required tools are installed.

task version

Native

Start Docker database containers.

task start db

Install Frappe dependencies.

task install

Install app.

task install-app uppsala https://gitlab.com/hfmts/uppsala.git

Start frappe development server.

task start native

Docker

Start Docker containers.

task start all

Install app.

task docker-install-app uppsala https://gitlab.com/hfmts/uppsala.git

Docker Development

Start Docker development containers.

task start dev

Install Frappe and setup site.

task docker-install-dev

Start the Docker development server.

task start bench