{"id":18969563,"url":"https://github.com/brionmario/jquery-mobile-starter","last_synced_at":"2026-04-15T14:34:33.974Z","repository":{"id":127160958,"uuid":"153786908","full_name":"brionmario/jquery-mobile-starter","owner":"brionmario","description":"💥  A quick start kit for jQuery Mobile Framework based website development with SASS support","archived":false,"fork":false,"pushed_at":"2022-01-29T06:50:55.000Z","size":599,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-02T11:10:07.438Z","etag":null,"topics":["featured-project","framework","gulp","jquery","jquery-mobile","php","portfolio","responsive","sass"],"latest_commit_sha":null,"homepage":"https://jquery-mobile-starter.herokuapp.com/","language":"SCSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/brionmario.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-10-19T13:28:12.000Z","updated_at":"2022-11-20T18:21:09.000Z","dependencies_parsed_at":null,"dependency_job_id":"608a0447-0997-4a52-bb89-d64f5e9675cf","html_url":"https://github.com/brionmario/jquery-mobile-starter","commit_stats":null,"previous_names":[],"tags_count":2,"template":true,"template_full_name":null,"purl":"pkg:github/brionmario/jquery-mobile-starter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brionmario%2Fjquery-mobile-starter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brionmario%2Fjquery-mobile-starter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brionmario%2Fjquery-mobile-starter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brionmario%2Fjquery-mobile-starter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/brionmario","download_url":"https://codeload.github.com/brionmario/jquery-mobile-starter/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brionmario%2Fjquery-mobile-starter/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31845956,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-15T13:28:40.153Z","status":"ssl_error","status_checked_at":"2026-04-15T13:28:29.396Z","response_time":63,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["featured-project","framework","gulp","jquery","jquery-mobile","php","portfolio","responsive","sass"],"created_at":"2024-11-08T14:53:28.942Z","updated_at":"2026-04-15T14:34:33.956Z","avatar_url":"https://github.com/brionmario.png","language":"SCSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"left\"\u003e\n    \u003cimg src=\"./docs/logo/jquery-mobile-starter.svg\" alt=\"logo-text\" width=\"200\" /\u003e\n    \u003cbr/\u003e\n    \u003ch1\u003ejQuery Mobile Starter\u003c/h1\u003e\n    \u003cp style=\"font-size: 1.2rem;\"\u003eA quick start kit for jQuery Mobile Framework based website development\u003c/p\u003e\n\u003c/p\u003e\n\n\u003c!-- Badges --\u003e\n\u003cp align=\"left\"\u003e\n  \u003ca href=\"https://travis-ci.org/brionmario/jquery-mobile-starter\"\u003e\n    \u003cimg src=\"https://travis-ci.org/brionmario/jquery-mobile-starter.svg?branch=master\" alt=\"Build Status\" height=\"18\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"#contributors\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/all_contributors-1-orange.svg\" alt=\"All Contributors\" height=\"18\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"LICENSE.md\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/License-MIT-yellow.svg\" alt=\"License: MIT\" height=\"18\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://codecov.io/gh/brionmario/jquery-mobile-starter\"\u003e\n  \u003cimg src=\"https://codecov.io/gh/brionmario/jquery-mobile-starter/branch/master/graph/badge.svg\" /\u003e\n\u003c/a\u003e\n\u003c/p\u003e\n\nThis repository could be used by anyone who's looking for a quick starter kit for jQuery Mobile framework based website development. This boilerplate uses [Gulp](https://gulpjs.com/) for building and automating the workflow. Following are some key features we've included for you.\n\n- The most recent version of [jQuery Mobile 1.4.5](http://demos.jquerymobile.com/1.4.5/)\n- The ability to use html, php or jade.\n- Usage of [Sass: Syntactically Awesome Style Sheets](https://sass-lang.com/) over CSS.\n- Ready to go build system using Gulp.\n- Simplified development process with npm scripts.\n- Easilily integrate your favourite php libraries using [Composer](https://getcomposer.org/).\n- Ability to use your favorite bower packages.\n- Organized and easy to use folder structure for beginners.\n\n# Quick Links\n\n| [Demo](https://jquery-mobile-starter.herokuapp.com/) | [Documentation](http://demos.jquerymobile.com/1.4.5/) | [Theme Roller](https://themeroller.jquerymobile.com/) |\n| ---------------------------------------------------- | ----------------------------------------------------- | ----------------------------------------------------- |\n\n\n# Quick start\n\n\u003e The generated project have dependencies that require `Node.js` together with `npm` \u0026 `Composer`.\n\n**Install [Composer](https://getcomposer.org/) locally or globally by following the instructions listed [here](https://getcomposer.org/doc/00-intro.md#installation-linux-unix-macos).**\n\n**Make sure you have [Node](https://nodejs.org/en/download/) version \u003e= 8.0 and [npm](https://www.npmjs.com/) \u003e= 5 or [Yarn](https://yarnpkg.com).**\n\n```bash\n# clone our repository\n# --depth 1 removes all but one .git commit history\ngit clone --depth 1 https://github.com/brionmario/jquery-mobile-starter.git\n\n# change the directory\ncd jquery-mobile-starter\n\n# install the npm dependencies listed on package.json\nnpm install\n\n# install the composer dependencies listed on composer.json\nComposer install\n\n# start the development server\nnpm start\n\n```\n\nOnce the dev server is fired up, it'll automatically open up a new tab. If not, manually navigate to the local URL listed on the terminal(usually [http://localhost:8000](http://localhost:8000)).\n\n# Table of Contents\n\n- [File Structure](#file-structure)\n- [Getting Started](#getting-started)\n  - [Prerequisites](#prerequisites)\n  - [Setting Up](#setting-up)\n  - [Running the app](#running-the-app)\n- [Configuration](#configuration)\n  - [Add third-party dependencies](#add-third-party-dependencies)\n    - [Composer](#composer)\n    - [Bower](#bower)\n- [Styling](#styling)\n- [Deployment](#deployment)\n  - [Heroku](#deploy-to-heroku)\n- [Built With](#built-with)\n- [Contributing](#contributing)\n- [Contributors](#contributors)\n- [License](#license)\n\n# File Structure\n\n```\njquery-mobile-starter/\n ├── coverage/                      * unit test coverage reports\n ├── dev/                           * stores development build artifacts\n ├── dist                           * stores production build artifacts\n ├── docs/                          * contains documents and document resources\n ├── node_modules/                  * contains dependencies pulled from npm\n ├── src/                           * source folder\n │   ├── assets/                    * static assets such as images, icons, fonts goes here\n │   ├── components/                * reusable components can be placed here\n │   ├── scss/                      * styles folder\n │   │   ├── partials/              * place all the sass partial stylesheets in this folder\n │   │   └── styles.scss            * the main stylesheet for the project which gets compiled to CSS\n │   ├── scripts/                   * custom javascript script files\n │   ├── bower_components/          * third party bower libraries will be copied here\n │   ├── composer-demo.php          * demo of the composer dependency management\n │   ├── demo.php                   * file containing the demo sorce code\n │   └── index.php                  * entry php file\n ├── vendor/                        * packages pulled from composer will be stored here\n ├── .all-contributorsrc            * contains info ablout repo contributors\n ├── .babelrc                       * babel build config file\n ├── .bowerrc                       * bower config file\n ├── .buildpacks                    * contains heroku buildpacks\n ├── .dockerignore                  * contains files that are ignored from docker\n ├── .editorconfig                  * helps define and maintain consistent coding styles between different editors and IDEs\n ├── .eslintrc                      * ecmascript linting configuration file\n ├── .gitignore                     * contains files that are ignored from git\n ├── .npmrc                         * npm config file to house project wide custom configs\n ├── .nvmrc                         * node version manager config file\n ├── .pullapprove.yml               * pullapprove config file\n ├── .sass-lint.yml                 * sass linting configuration file\n ├── .travis.yml                    * travis ci configuration file\n ├── app.json                       * heroku manifest format for describing app\n ├── bower.json                     * contains bower dependencies\n ├── CHANGELOG.md                   * version changelog\n ├── composer.json                  * contains php project requirements\n ├── CONTRIBUTING.md                * project contributing guidelines\n ├── docker-compose.yml             * docker compose file\n ├── Dockerfile                     * docker config file\n ├── gulpfile.babel.js              * main buld configuration file. contains all the gulp tasks.\n ├── LICENSE.md                     * licensing information\n ├── package.json                   * contains all the npm scripts for building, running, deploying etc. and contains all the dependencies\n ├── Procfile                       * contains commands to be executed by heroku at app startup\n └── README.md                      * Readme file for the repository\n\n```\n\n# Getting Started\n\n## Prerequisites\n\nWhat you need to run this app:\n\n- The generated project have dependencies that require `Node.js` together with `npm` and `Composer`.\n\n\u003e Make sure you have `Node.js`, `npm` \u0026 `Composer` installed by running the following simple commands on the command line and see if you're running the latest stable versions.\n\n- Node.js - Type `node -v` on the terminal.\n- npm - Type `npm -v` on the terminal.\n- Composer - Type `Composer -v` on the terminal.\n\nIf you do not have them installed, click [here](https://nodejs.org/en/download/) and grab the latest stable version of `Node.js` and `npm` will be automatically installed along with it. Or if you have `brew` already installed in your local machine, execute `brew install node` command to get `node`.\n\nTo download composer, click [here](https://getcomposer.org/doc/00-intro.md#installation-linux-unix-macos) and follow the download instructions.\n\nThe project requires `bower` to install project scope dependencies such as `bootstrap`, `jquery` etc. but it is not required to install bower on your local machines since `npm` installs `bower` as a project dependency. Also `bower install` command is run automatically by `npm` as a post install script.\n\nIn addition we've created `npm scripts` to run `gulp tasks` and `gulp` is installed by npm as a project depency. So you don't have to install `gulp` or `gulp cli` manually on your working machine.\n\n## Setting Up\n\n- `clone` the repository\n- `cd jquery-mobile-starter` to change the directory\n- `npm install` to install npm dependencies\n- `Composer install` to install composer dependencies\n\n## Running the app\n\nAfter you have installed all dependencies you can now run the app. Run `npm start` to start a local server using `gulp` which will watch your stylesheets and javascript files for changes, compile, minify, build and reload the browser automatically using `browser-sync` library.\nThe dev server will be opened in a new tab and usually on http://localhost:8000 and the Access URLs will be displayed on the terminal.\n\n### server\n\n```bash\n# development\nnpm start\n\n# production\nnpm run server:prod\n```\n\n# Configuration\n\nThe `gulp` tasks are defined inside the `gulpfile.babel.js` file found on the root of the application and you need to extend this file if you want to customize the application.\n\n## Add third-party dependencies\n\n### Composer\n\nTo integrate PHP libraries from composer, visite the packge repository website([https://packagist.org/](https://packagist.org/)) and follow the instructions. The command to install the package would generally look loke below. Replace the `$package` with the actual package you want to install.\n\n```bash\ncomposer require $package\n```\n\nTake a look at the bellow example:\n\nLets say that you want to integrate `facebook/graph-sdk` to your project. Just run the command bellow.\n\n```bash\ncomposer require facebook/graph-sdk\n```\n\n### Bower\n\nTo use any third party bower libraries other than the included `jquery-mobile`, `jquery` and `font-awesome` libs, locate the package you want in the [bower package repository](https://bower.io/search/) and use the following command to add it to your project.\n\n```bash\nbower install $package --save\n```\n\nTake a look at the bellow example:\n\nLets say that you want to add `moment.js` to your project. Just run the command bellow.\n\n```bash\nbower install moment --save\n```\n\nNOTE: Some packages won't work as expected and you might have to do overrides in the `bower.json` file.\n\n# Styling\n\nThe `styles.scss` file inside the `sass` directory is the main stylesheet for the project and will be compiled and minified into an external `.css` and is embedded in the `index.html` file.\nIf you want to add your own stylesheet, we recommend that you place it under the `scss/partials` folder and import it in the `styles.scss` file.\n\nFor example if you want to include the styles for a slider:\n\n1. Create a `_slider.scss` partial file in the `scss/partials` directory.\n2. In `styles.scss` add `@import 'partials/slider.scss';`\n\nFor the purpose of the demo, we have overriden the native look and feel of some jQuery mobile components. Feel free to remove them by locating in partials.\n\n# Testing\n\nExecute the following command to run your unit tests. We use [codecov](https://codecov.io/) package to generate test coverage reports and the generated reports can be found in the `coverage` folder.\n\n```bash\nnpm run test\n```\n\n# Linting\n\nExecute the following commands to generate linting for styles and scripts.\n\n```bash\n# all\nnpm run lint\n\n# javascript\nnpm run lint:scripts\n\n# sass\nnpm run lint:styles\n```\n\n# Deployment\n\n## Building the app\n\n### For Development\n\nExecute the following command to build your files in the development mode. A new folder called `dev` will be created and the artifacts will be saved there.\n\n```bash\nnpm run build:dev\n```\n\n### For Production\n\nExecute the following command to build your files in the production mode. A new folder called `dist` will be created and the artifacts will be saved there.\n\n```bash\nnpm run build\n```\n\n## Deploy to Heroku\n\nDeploy to [Heroku](https://www.heroku.com/) using this template with one single click. Heroku has an awesome free and it is extremely easy to use.\n\nClick [here](https://jquery-mobile-starter.herokuapp.com/) to see the deployed app.\n\n\u003c!-- Markdown snippet --\u003e\n\n[![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy)\n\n# Built With\n\n\u003ca href=\"https://jquerymobile.com\"\u003e\n  \u003cimg src=\"./docs/readme-resources/technologies/jquery-mobile.svg\" alt=\"npm\" height=\"20\" /\u003e\n\u003c/a\u003e\u0026nbsp;\u0026nbsp;\n\u003ca href=\"https://getcomposer.org/\"\u003e\n  \u003cimg src=\"./docs/readme-resources/technologies/composer.svg\" alt=\"Composer\" height=\"30\" /\u003e\n\u003c/a\u003e\u0026nbsp;\u0026nbsp;\n\u003ca href=\"http://php.net/\"\u003e\n  \u003cimg src=\"./docs/readme-resources/technologies/php.png\" alt=\"npm\" height=\"25\" /\u003e\n\u003c/a\u003e\u0026nbsp;\u0026nbsp;\n\u003ca href=\"https://www.npmjs.com/\"\u003e\n  \u003cimg src=\"./docs/readme-resources/technologies/npm.svg\" alt=\"npm\" height=\"20\" /\u003e\n\u003c/a\u003e\u0026nbsp;\u0026nbsp;\n\u003ca href=\"https://bower.io/\"\u003e\n  \u003cimg src=\"./docs/readme-resources/technologies/bower.svg\" alt=\"bower\" height=\"30\" /\u003e\n\u003c/a\u003e\u0026nbsp;\u0026nbsp;\n\u003ca href=\"https://sass-lang.com/\"\u003e\n  \u003cimg src=\"./docs/readme-resources/technologies/sass.svg\" alt=\"sass\" height=\"30\" /\u003e\n\u003c/a\u003e\u0026nbsp;\u0026nbsp;\n\u003ca href=\"https://gulpjs.com/\"\u003e\n  \u003cimg style=\"display:inline-block;margin: 5px 10px\" src=\"./docs/readme-resources/technologies/gulp.svg\" alt=\"gulp\" height=\"30\" /\u003e\n\u003c/a\u003e\n\n# Changelog\n\nPlease refer [CHANGELOG.md](CHANGELOG.md) to learn about the latest improvements, breaking changes and bug fixes.\n\n# Contributing\n\nPlease read [CONTRIBUTING.md](CONTRIBUTING.md) for contributing guidelines and to learn about our code of conduct.\n\n# Contributors\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --\u003e\n\u003c!-- prettier-ignore --\u003e\n| [\u003cimg src=\"https://avatars3.githubusercontent.com/u/25959096?v=4\" width=\"80px;\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eBrion Mario\u003c/b\u003e\u003c/sub\u003e](http://www.brionmario.com/)\u003cbr /\u003e[💻](https://github.com/brionmario/jquery-mobile-starter/commits?author=brionmario \"Code\") [📖](https://github.com/brionmario/jquery-mobile-starter/commits?author=brionmario \"Documentation\") [🐛](https://github.com/brionmario/jquery-mobile-starter/issues?q=author%3Abrionmario \"Bug reports\") [⚠️](https://github.com/brionmario/jquery-mobile-starter/commits?author=brionmario \"Tests\") |\n| :---: |\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:END --\u003e\n\nThis project follows the [all-contributors](https://github.com/kentcdodds/all-contributors) specification. Contributions of any kind welcome!\n\n# License\n\nThis project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrionmario%2Fjquery-mobile-starter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbrionmario%2Fjquery-mobile-starter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrionmario%2Fjquery-mobile-starter/lists"}