thecoati/surf

Docker files for running a basic Radicle application.

Maintainers

Details

github.com/TheCoati/Surf

Homepage

Source

Issues

Fund package maintenance!
TheCoati

Installs: 2

Dependents: 0

Suggesters: 0

Security: 0

Stars: 3

Watchers: 2

Forks: 2

Type:project

dev-develop 2023-04-10 23:12 UTC

Requires

Requires (Dev)

MIT 4f46b212c5247e22681b5bfd35961f5af990d1f8

  • TheCoati

dockersailradicle

This package is auto-updated.

Last update: 2024-05-11 01:39:20 UTC

README

Radicle Surf is Laravel Sail modified to be compatible with Radicle.

Note
Radicle Surf is currently still under development.
Currently only the MySQL service has been added.

Table of Contents

Introduction

Radicle Surf is a light-weight command-line interface for setting up a Radicle Docker development environment based on Laravel Sail. Surf provides a great starting point for building a Radicle application using PHP, MySQL, and Redis without requiring prior Docker experience.

At its heart, Surf is the docker-compose.yml file and the surf script that is stored at the root of your project. The surf script provides a CLI with convenient methods for interacting with the Docker containers defined by the docker-compose.yml file.

Radicle Surf is supported on macOS, Linux, and Windows (via WSL2).

Installation & Setup

You may simply install Surf using the Composer package manager. Of course, these steps assume that your existing local development environment allows you to install Composer dependencies:

composer require thecoati/surf --dev

After Surf has been installed, you may run the surf install. This command will publish Surf's docker-compose.yml file to the root of your application:

./vendor/bin/surf install

Finally, you may start Surf.

./vendor/bin/surf up

Configuring A Shell Alias

By default, Surf commands are invoked using the vendor/bin/surf script:

./vendor/bin/surf up

However, instead of repeatedly typing vendor/bin/surf to execute Surf commands, you may wish to configure a shell alias that allows you to execute Surf's commands more easily:

alias surf='[ -f surf ] && sh surf || sh vendor/bin/surf'

To make sure this is always available, you may add this to your shell configuration file in your home directory, such as ~/.zshrc or ~/.bashrc, and then restart your shell.

Once the shell alias has been configured, you may execute Surf commands by simply typing surf. The remainder of this documentation's examples will assume that you have configured this alias:

surf up