PHPackages                             me-io/appium-selenium-starter - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Testing &amp; Quality](/categories/testing)
4. /
5. me-io/appium-selenium-starter

ActiveProject[Testing &amp; Quality](/categories/testing)

me-io/appium-selenium-starter
=============================

Simple and easy to use boilerplate for writing tests for mobile or web.

1.0.0(8y ago)29205[1 issues](https://github.com/me-io/appium-selenium-starter/issues)MITPHP

Since Feb 9Pushed 7y ago6 watchersCompare

[ Source](https://github.com/me-io/appium-selenium-starter)[ Packagist](https://packagist.org/packages/me-io/appium-selenium-starter)[ RSS](/packages/me-io-appium-selenium-starter/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (2)Versions (3)Used By (0)

 Appium Selenium Starter
=========================

[](#--appium-selenium-starter-)

Simple and easy to use boilerplate for writing tests for mobile or web.

---

[![Build Status](https://camo.githubusercontent.com/819494269f66a9fb067ce5ff9edce0ad35907b4f26e97ec5ae302fed991999c6/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f6d652d696f2f61707069756d2d6472697665722d636f646563657074696f6e2e7376673f7374796c653d666c61742d737175617265)](https://travis-ci.org/me-io/appium-driver-codeception)[![downloads](https://camo.githubusercontent.com/9ac9667522482413749dc9b6a80416bdc61692ada02822c721a9a351f39763d9/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f6d652d696f2f61707069756d2d73656c656e69756d2d737461727465722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/me-io/appium-selenium-starter/stats)[![MIT License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](https://github.com/me-io/appium-selenium-starter/blob/master/LICENSE.md)[![Donate](https://camo.githubusercontent.com/21b9b3571c7f2fc583ad6b1b49aeb1524dd82f18a1b2e83c005c570cb71816ab/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f70617970616c2d646f6e6174652d3137394244372e7376673f7374796c653d666c61742d73717561726573)](https://www.paypal.me/meabed)

[![All Contributors](https://camo.githubusercontent.com/db0a672758a6b3f2641e6c6099e3fadfd608167acfae3b31425eb3917b0dc47f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f616c6c5f636f6e7472696275746f72732d322d6f72616e67652e7376673f7374796c653d666c61742d737175617265)](#contributors)[![PRs Welcome](https://camo.githubusercontent.com/25b3e6d0d42c98de74a98cbb4d149a1c09020cf6d1361993b72d7d5b8ffed363/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5052732d77656c636f6d652d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](http://makeapullrequest.com)[![Code of Conduct](https://camo.githubusercontent.com/6cf3a420df991efb9d5319bcf31f1aec6d12e660e25f13256cb256e76a4399a7/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f636f64652532306f662d636f6e647563742d6666363962342e7376673f7374796c653d666c61742d737175617265)](https://github.com/me-io/appium-selenium-starter/blob/master/CODE_OF_CONDUCT.md)[![Watch on GitHub](https://camo.githubusercontent.com/da7ceb6c052d1db96e5f18bc776763cf699f7cd56b01131ffd5679368e3cbd5b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f77617463686572732f6d652d696f2f61707069756d2d73656c656e69756d2d737461727465722e7376673f7374796c653d736f6369616c)](https://github.com/me-io/appium-selenium-starter/watchers)[![Star on GitHub](https://camo.githubusercontent.com/044c6f2f4164b5c52b8918b14c6d00a3583fb0b48aba718d70bb4d5f69d1f311/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6d652d696f2f61707069756d2d73656c656e69756d2d737461727465722e7376673f7374796c653d736f6369616c)](https://github.com/me-io/appium-selenium-starter/stargazers)[![Tweet](https://camo.githubusercontent.com/84ea754165a8a12ee4a98f38a83806bbf8b962d877bbb420849671da3cb3ce40/68747470733a2f2f696d672e736869656c64732e696f2f747769747465722f75726c2f68747470732f6769746875622e636f6d2f6d652d696f2f61707069756d2d73656c656e69756d2d737461727465722e7376673f7374796c653d736f6369616c)](https://twitter.com/intent/tweet?text=Check%20out%20appium-selenium-starter!%20https://github.com/me-io/appium-selenium-starter%20%F0%9F%91%8D)

Requirements
------------

[](#requirements)

1. PHP &gt;= 7.0
2. Appium - For Mobile Testing
3. Selenium - For Web application testing

Installation
------------

[](#installation)

You can install this `appium-selenium-starter` using the following methods:

### Cloning the repo

[](#cloning-the-repo)

Run the following command to configure the boilerplate on your machine:

```
git clone git@github.com:me-io/appium-selenium-starter.git
```

### Via composer create-project

[](#via-composer-create-project)

Alternatively, you may also install `appium-selenium-starter` by issuing the Composer create-project command in your terminal:

```
composer create-project --prefer-dist me-io/appium-selenium-starter
```

Installing Dependencies
-----------------------

[](#installing-dependencies)

Now run the following command to install required dependencies:

```
composer install
```

Configuring Environment
-----------------------

[](#configuring-environment)

There are two cli applications included in starter. To view a list of all commands in these cli applications inside your terminal run the following commands one by one:

```
composer run appium
composer run selenium
```

### Appium

[](#appium)

Lets configure your environment for running mobile application testing. Open your terminal and run the following command:

```
composer run appium configure
```

### Selenium

[](#selenium)

To configure your environment for running selenium server run the below command:

```
composer run selenium configure
```

Running Example Tests
---------------------

[](#running-example-tests)

> **Note:** For running example tests you need to have installed and configured the android emulator or iOS simulator on your machine.

Before running the mobile tests we need to start the appium server. To start appium server run the following command inside your terminal:

```
composer run appium start
```

We need to move everything from `example` directory to the root folder of the project. Run the following command inside your terminal:

```
mv example/* .
```

You can find the android and ios example tests inside `/tests` directory. We also put some example apps for android and ios inside `/tests/_data/test-apps` directory.

Android Tests
-------------

[](#android-tests)

For running android emulator we are using genymotion. Follow this [guide](https://shankargarg.wordpress.com/2016/02/25/setup-genymotion-android-emulators-on-mac-os/)if you do not know how to install and run android emulator. You also need to install the application that you want to test inside android emulator.

### Update Suite

[](#update-suite)

Now you need to update the `android.suite.yml` you can find this filw inside `tests` directory. And also update the `deviceName` to your android emulator device name. If you have genymotion installed you can find the device name from the devices list.

[![Imgur](https://camo.githubusercontent.com/a2ebf50bbbde341ebf513a25e95999995eaa8e821ec30df488131924cb53773f/68747470733a2f2f692e696d6775722e636f6d2f7a6e516b754c712e706e67)](https://camo.githubusercontent.com/a2ebf50bbbde341ebf513a25e95999995eaa8e821ec30df488131924cb53773f/68747470733a2f2f692e696d6775722e636f6d2f7a6e516b754c712e706e67)

### Running Tests

[](#running-tests)

To run the android tests run the following codecept command inside your terminal:

```
./vendor/bin/codecept -c example/codeception.yml run android --steps
```

[![Android](https://camo.githubusercontent.com/400d199cca4b3c1345d33625aaa6ccab4ee8c8059534a00b25fb3ad1ff484e69/68747470733a2f2f692e696d6775722e636f6d2f506471445246612e676966)](https://camo.githubusercontent.com/400d199cca4b3c1345d33625aaa6ccab4ee8c8059534a00b25fb3ad1ff484e69/68747470733a2f2f692e696d6775722e636f6d2f506471445246612e676966)

> **Note:** Make sure appium server is running before running the android tests.

iOS Tests
---------

[](#ios-tests)

First you need to run the appium server than you need to start the iOS simulator. Use the following if you do not know how to run iOS sumulator .

### Update Suite

[](#update-suite-1)

Now you need to update the `ios.suite.yml` you can find this file inside `tests` directory. Open `ios.suite.yml` file and update `xcodeOrgId` and `udid` to your running simulator `identifier` string. You can find your `identifier` string by opening the simulator then `Hardware > Device > Manage Devices > Simulators`. You will find a list of iOS devices now open the device that you are running and after clicking on the device name you will find the `identifier` string.

[![](https://camo.githubusercontent.com/337e248bfa0939877d9c323265f05146b699ce74a072062cddd47ca43cc2d09e/68747470733a2f2f6472356d6f3573376c717274632e636c6f756466726f6e742e6e65742f6974656d732f3035324e316632553052337231363143324133322f25354237386165313036663165663866316637316263646566643464626335653232312535445f496d6167652b323031382d30322d31342b61742b362e31382e30322b504d2e706e673f582d436c6f75644170702d56697369746f722d49643d3239363033383826763d3032396165393839)](https://camo.githubusercontent.com/337e248bfa0939877d9c323265f05146b699ce74a072062cddd47ca43cc2d09e/68747470733a2f2f6472356d6f3573376c717274632e636c6f756466726f6e742e6e65742f6974656d732f3035324e316632553052337231363143324133322f25354237386165313036663165663866316637316263646566643464626335653232312535445f496d6167652b323031382d30322d31342b61742b362e31382e30322b504d2e706e673f582d436c6f75644170702d56697369746f722d49643d3239363033383826763d3032396165393839)

### Running Tests

[](#running-tests-1)

To run the ios tests run the following codecept command inside your terminal:

```
./vendor/bin/codecept -c example/codeception.yml run ios --steps
```

[![iOS](https://camo.githubusercontent.com/8b665ee2057b02fca739d556d7e773a1f7427a64768d0e5071a8da4a69e29d3b/68747470733a2f2f692e696d6775722e636f6d2f417534356658762e676966)](https://camo.githubusercontent.com/8b665ee2057b02fca739d556d7e773a1f7427a64768d0e5071a8da4a69e29d3b/68747470733a2f2f692e696d6775722e636f6d2f417534356658762e676966)

Contributors
------------

[](#contributors)

A huge thanks to all of our contributors:

[![](https://avatars0.githubusercontent.com/u/45731?v=3)
**Mohamed Meabed**](https://github.com/Meabed)
[💻](https://github.com/me-io/appium-selenium-starter/commits?author=Meabed "Code") [📢](#talk-Meabed "Talks")[![](https://avatars2.githubusercontent.com/u/16267321?v=3)
**Zeeshan Ahmad**](https://github.com/ziishaned)
[💻](https://github.com/me-io/appium-selenium-starter/commits?author=ziishaned "Code") [🐛](https://github.com/me-io/appium-selenium-starter/issues?q=author%3Aziishaned "Bug reports") [⚠️](https://github.com/me-io/appium-selenium-starter/commits?author=ziishaned "Tests") [📖](https://github.com/me-io/appium-selenium-starter/commits?author=ziishaned "Documentation")License
-------

[](#license)

The code is available under the [MIT license](LICENSE.md).

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance19

Infrequent updates — may be unmaintained

Popularity18

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 97.1% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

3005d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/e0688fa386c5dbcbb27c78b325cf9a957ddf8b07c3bf53271060e2a32aa91975?d=identicon)[meabed](/maintainers/meabed)

---

Top Contributors

[![ziishaned](https://avatars.githubusercontent.com/u/16267321?v=4)](https://github.com/ziishaned "ziishaned (34 commits)")[![meabed](https://avatars.githubusercontent.com/u/45731?v=4)](https://github.com/meabed "meabed (1 commits)")

---

Tags

appiumautomationautomation-testcodeceptionqa-automation-testseleniumtestingunittestunit testingseleniumboilerplateappiummobile-testingandroid-testingios-testing

### Embed Badge

![Health badge](/badges/me-io-appium-selenium-starter/health.svg)

```
[![Health](https://phpackages.com/badges/me-io-appium-selenium-starter/health.svg)](https://phpackages.com/packages/me-io-appium-selenium-starter)
```

###  Alternatives

[sauce/sausage

PHP version of the Sauce Labs API

70807.6k3](/packages/sauce-sausage)[elliotchance/concise

Concise is test framework for using plain English and minimal code, built on PHPUnit.

45223.8k4](/packages/elliotchance-concise)[unigen/unigen

UniGen is a unit test generator for PHP. It automatically generates unit tests for your classes

2340.6k1](/packages/unigen-unigen)[funkatron/funit

The testing microframework for PHP 5.3+, partially inspired by QUnit.

841.9k14](/packages/funkatron-funit)[sofa/eloquent-testsuite

Helpers for fast and reliable UNIT tests for your Eloquent Models with PHPUnit

10104.7k](/packages/sofa-eloquent-testsuite)[unigen/unigen-bundle

Symfony bundle for unigen test generator

1227.8k](/packages/unigen-unigen-bundle)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
