artiframe serve

The artiframe serve command starts a local server to develop your application. However, instead of running a plain php -S command, ArtiFrame launches the ArtiFrame Server Studio—a graphical interface where you can monitor server logs, performance metrics, and PHP configurations.

Usage

$ artiframe serve [port]

Parameters

Parameter	Description
`[port]`	(Optional) Specifies the port number the server will run on. If not provided, it defaults to port 9002.

Examples

# Start with the default port (localhost:9002)
$ artiframe serve

# Start with a custom port (localhost:8080)
$ artiframe serve 8080

What Happens Behind the Scenes?

When you run the command, the system first verifies whether the current directory is an ArtiFrame project (by checking for the existence of public/index.php). Then, to avoid locking up your terminal, it sends the process to the background and triggers the Electron-based Server Studio application.

$ artiframe serve 8000
  🚀  Launching ArtiFrame Server Studio...
  ✅ Server Studio opened in the background. Check the advanced interface.

Through Server Studio, you can monitor HTTP requests in real-time, catch PHP Fatal Errors in much greater detail, and stop or start the server with a single click.

Requirement: For this command to work, you must be in the root directory where you initialized the project (where you ran artiframe new), otherwise you will encounter an error.