{"id":13831860,"url":"https://github.com/sourcebitsllc/chocolatechip-ui","last_synced_at":"2025-07-09T15:33:48.535Z","repository":{"id":6686023,"uuid":"7931092","full_name":"sourcebitsllc/chocolatechip-ui","owner":"sourcebitsllc","description":"Mobile Web App Framework","archived":false,"fork":true,"pushed_at":"2015-04-18T23:11:03.000Z","size":57842,"stargazers_count":617,"open_issues_count":9,"forks_count":88,"subscribers_count":44,"default_branch":"master","last_synced_at":"2024-10-27T19:55:30.055Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"www.chocolatechip-ui.com","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"rbiggs/chocolatechip-ui","license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sourcebitsllc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"MIT-LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-01-31T05:44:48.000Z","updated_at":"2024-02-07T18:17:20.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/sourcebitsllc/chocolatechip-ui","commit_stats":null,"previous_names":[],"tags_count":25,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sourcebitsllc%2Fchocolatechip-ui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sourcebitsllc%2Fchocolatechip-ui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sourcebitsllc%2Fchocolatechip-ui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sourcebitsllc%2Fchocolatechip-ui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sourcebitsllc","download_url":"https://codeload.github.com/sourcebitsllc/chocolatechip-ui/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225565942,"owners_count":17489288,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":[],"created_at":"2024-08-04T10:01:42.751Z","updated_at":"2024-11-20T13:31:57.105Z","avatar_url":"https://github.com/sourcebitsllc.png","language":"HTML","readme":"#ChocolateChip - A Compact Framework for Mobile Web Apps\n\n#Attention!\n##We have consolidated ChocolateChip-UI and all other projects related to it under an new Github repository [chocolatechipui](https://github.com/chocolatechipui). All future work will be done under that account. Please update your forks or clones to point to that repository.\n\n###ChocolateChip-UI has been acquired by [Sourcebits Inc](http://www.sourcebits.com).\n\n##ChocolateChip-UI\n\nChocolateChip-UI is a framework for making mobile Web apps. It has three components: semantic HTML5 markup, CSS and JavaScript. To successfully make an app with ChocolateChip-UI you'll need at least moderate experience working with JavaScript. This is so you can use templates, make Ajax requests and handle callbacks for user interaction. If this is beyond your current skills, consider getting someone with Web development experience to help you. ChocolateChip-UI is built on jQuery, so you will need a compatible version of it to work with ChocolateChip-UI.\n\nPlease visit [ChocolateChip-UI's Website](http://chocolatechip-ui.com) for documentation and tutorials. This project includes examples for iOS, Android and Windows Phone 8 to help you get going.\n\n##Building \n\nIf you do not want to build the framework from scratch, you can use the pre-compiled version in the dist folder. This is just the framework, minus examples, demos, etc.\n\nChocolateChip-UI uses Gulpjs to build. This is a Node package, so you'll first need to have [Node installed](http://http://nodejs.org). After installing Nodejs, or if you already have it installed, on Mac OS X use the terminal to cd to the directory. On Windows you can use the Windows command prompt to do this. Once you are in the folder, run the following command in your terminal. \n\n###Gulpjs\n\nOn Mac OS X, you'll need to run the command in your terminal with **sudo** to avoid installation errors:\n\n```shell\nsudo npm install -g gulp\n``` \n\n\nFor Windows, just run this:\n\n```shell\nnpm install -g gulp\n```\n\nEnter your password when it requests. After you should see a number of Nodejs modules being installed in a folder called **node\\_modules**. You do not need **node\\_modules** in your final project. The node modules are there to enable the build process with Gruntjs.\n\nNow that you have the node modules install, you can just type `gulp` in the terminal and hit return/enter. This will kick off the build process, which will produce the following directories:\n\n```\nchui/\ndata/\ndemo/\nexamples-android/\nexamples-ios/\nexamples-win/\nimages/\nnode_modules/\n```\n\nIf you're starting a new project, you only need the files in the **chui** folder. If you want to create a custom build, then just run any of the tasks:\n\n```\ngulp js android\n```\n\n```\ngulp js ios\n```\n\n```\ngulp js win\n```\n\nThese will build the ChUI JavaScript file, normal and minified, as well as the OS theme normal and minified.\n\nYou can also build out just the examples for a particular platform:\n\n\n```\ngulp android_examples\n```\n\n```\ngulp ios_examples\n```\n\n```\ngulp win_examples\n```\n\nThis will include the ChUI JavaScript, the theme and all the examples for that platform.\n\nIf you intend to customize a theme for branding purposes, you should do so in the LESS files in the source. But instead of having to rebuild the theme each time, you can ask Gulp to watch the theme. That means every time you make a change and save a file, Gulp will rebuild the theme for you.\n\nTo watch all there themes, run:\n\n```\ngulp watch\n```\n\nTo watch specific platform theme, run one of these:\n\n```\ngulp watch_android\n```\n\n```\ngulp watch_ios\n```\n\n```\ngulp watch_win\n```\n\nYou could also build a theme and watch it all at once:\n\n```\ngulp js android \u0026\u0026 gulp watch_android\n```\n\n```\ngulp js ios \u0026\u0026 gulp watch_ios\n```\n\n```\ngulp js win \u0026\u0026 gulp watch_win\n```\n##ChocolateChipJS\n\nIf you want to use ChocolateChipJS instead of jQuery, you can just run the following command:\n\n\n```\ngulp --chocolatechipjs\n```\n\nThis will put the latest version of ChocolateChipJS in the chui folder and also output all examples to use ChocolateChipJS instead of jQuery. You can learn more about how to use ChocolateChipJS on [our website](http://chocolatechip-ui.com).\n\n###Note\n\nYou do not need Nodejs to use ChocolateChip-UI. Nodejs is only used to build the framework and examples from the source files.\n\n##Contributing Code\n###Avoiding Carriage Returns in Commits\n\nChocolateChip-UI uses Unix linefeeds (LF) for new lines. Github for Windows adds carriage returns to linefeeds (CRLF). If you try to check in such files, Git will flag every line with changed new lines, which means practically everything. To avoid this we've added a .gitattributes file to the repository. This will prevent Github from converting the new lines on Windows. \n\nIf you are editing the source code on Windows, depending on the text editor you are using, or if you do a copy/paste, you may inadvertently introduce Windows carriage returns. Also some Grunt actions, such as concatenation with banners, automatically create newlines with carriage returns on Windows. When these carriage returns are added to the source code, they will show up as a changes at commit time. You can avoid this. Navigate to the ChocolateChip-UI repository in the command prompt, then execute these two Git commands:\n\n```\ngit config core.eol lf\ngit config core.autocrlf input\n```\n\ncore.eol tells Git to always checkout this repository with LF. \ncore.autocrlf tells Git to convert CRLF to LF on commit.\n\n","funding_links":[],"categories":["HTML","📦 Legacy \u0026 Inactive Projects"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsourcebitsllc%2Fchocolatechip-ui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsourcebitsllc%2Fchocolatechip-ui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsourcebitsllc%2Fchocolatechip-ui/lists"}