Skip to content

Commit 73f3f65

Browse files
authored
Merge pull request #378 from origamiphp/feature/documentation
Move the documentation to the repository wiki
2 parents d62a737 + 175e533 commit 73f3f65

File tree

1 file changed

+3
-109
lines changed

1 file changed

+3
-109
lines changed

README.md

Lines changed: 3 additions & 109 deletions
Original file line numberDiff line numberDiff line change
@@ -23,115 +23,8 @@ It allows you to create a new environment from scratch without impacting the sou
2323
offers the ability to have a global overview of all installed environments and perform actions without having to be in
2424
the project directory. Native commands are still available since this is a wrapper of [Docker Compose][docker-compose].
2525

26-
## 📦 Prerequisites
27-
* [Docker][docker-engine] and [Docker Compose][docker-compose].
28-
* [Mutagen][mutagen] to improve performance because Docker can be [painfully slow on macOS][issue] with some projects.
29-
* [mkcert][mkcert] (optional) to make locally trusted development certificates because the HTTPS has become the norm.
30-
31-
**Last but not least, this package currently only supports macOS**.
32-
33-
## 🛠 Installing
34-
You can install `origami` with Composer like any PHP dependency.
35-
```shell script
36-
composer global require ajardin/origami
37-
```
38-
39-
Once you have installed the binary, you can check the status of the application requirements.
40-
```shell script
41-
origami --verbose
42-
```
43-
44-
## 🚀 Getting Started
45-
1. Open a terminal in the directory of your project
46-
2. Run `origami install`
47-
3. Configure the environment of your choice
48-
4. Run `origami start`
49-
5. Open your favorite browser on your custom domain or https://127.0.0.1/
50-
51-
The `var/docker/` directory of your project contains the environment configuration. Feel free to edit it at your
52-
convenience; it is your configuration now. 😉
53-
54-
## 🪄 Available Commands
55-
56-
### `origami configure:phpstorm`
57-
Copies the PhpStorm configuration associated to the current environment.
58-
59-
### `origami data`
60-
Shows real-time usage statistics of the running environment.
61-
62-
### `origami database:dump`
63-
Generates a database dump of the running environment.
64-
65-
### `origami:database:reset`
66-
Recreates the database volume of the running environment.
67-
68-
### `origami database:restore`
69-
Restores a database dump of the running environment.
70-
71-
### `origami debug`
72-
Shows system information and the configuration of the current environment.
73-
74-
### `origami install`
75-
Installs an environment for the project in the current directory.
76-
77-
### `origami logs [--tail=XX] [service]`
78-
Shows the logs generated in real-time by the running environment.
79-
80-
By default, this command only shows new entries. You can use the `--tail=XX` option to view previous entries, and filter
81-
the output by specifying the name of a service (`php` for example).
82-
83-
### `origami php`
84-
Opens a terminal on the `php` service to interact with it.
85-
86-
### `origami prepare`
87-
Prepares Docker images (i.e. pull and build) of a previously installed environment.
88-
89-
### `origami ps`
90-
Shows the status of the running environment services.
91-
92-
### `origami registry`
93-
Shows the list and status of all previously installed environments.
94-
95-
### `origami restart`
96-
Restarts an environment previously started.
97-
98-
### `origami root`
99-
Shows instructions for configuring your terminal to manually use Docker commands.
100-
101-
### `origami start`
102-
Starts an environment previously installed.
103-
104-
### `origami stop`
105-
Stops an environment previously started.
106-
107-
### `origami uninstall`
108-
Uninstalls an environment by deleting all Docker data and associated configuration.
109-
110-
You can either run this command from the directory where the project has been installed, or pass its name as an
111-
argument to the command.
112-
113-
### `origami update`
114-
Updates the configuration of a previously installed environment.
115-
116-
This command must be run after each `origami` update to ensure that you benefit from all the latest improvements.
117-
**Your manual changes are overwritten by this action.**
118-
119-
## 🔍 Architecture
120-
`origami` relies on [Symfony][symfony], a popular PHP framework.
121-
122-
Unlike common Symfony projects, we use [Box][box] to package the tool into a single binary file so that it's possible to
123-
share it without installing all its dependencies. Otherwise, it could potentially bring conflicts if other tools with
124-
outdated dependencies are present on the local machine.
125-
126-
**Why PHP?** The main reason is that `origami` will focus on environments dedicated to PHP applications, and we would
127-
like to facilitate the contribution process by using something well-known by our end-users.
128-
129-
## ✅ Testing
130-
There is a `Makefile` with the most useful commands (e.g. fixing the coding style or running the tests).
131-
132-
```shell script
133-
make
134-
```
26+
## 📚 Documentation
27+
To discover how to install and use `origami`, please have a look at the [wiki page][wiki].
13528

13629
## 🤝 Contributing
13730
Contributions, issues and feature requests are welcome! Feel free to check [issues page][contributions].
@@ -153,3 +46,4 @@ Copyright © [Alexandre Jardin][me]. `origami` is an open-sourced software licen
15346
[orocommerce]: https://oroinc.com/
15447
[sylius]: https://sylius.com/
15548
[symfony]: https://symfony.com/
49+
[wiki]: https://github.com/origamiphp/source/wiki

0 commit comments

Comments
 (0)