Cozy Template

⚠️ This repo is deprecated. Prefer to use https://github.com/cpatchane/cozy-create-app ⚠️

What's Cozy?

Cozy is a platform that brings all your web services in the same private space. With it, your webapps and your devices can share data easily, providing you with a new experience. You can install Cozy on your own hardware where no one's tracking you.

What's cozy-template?

This repository is a client-side app skeleton for Cozy Cloud^v3. We keep it up-to-date with our habits and best-practices. It allow you to bootstrap an app from scratch in a breeze.

Use it

Step 1: clone the app

$ git clone \
  --origin=template \
  --depth=1 \
  https://github.com/cozy/cozy-template.git \
  my-app

Step 2: customize templates resources

The my-app/.templates dir contains some templates you can use in your final repository. You should copy them to the root of your project (excepted the .transifexrc file). Be careful that those files contains some vars you must replace to have the files fully functional:

• <APP_NAME>: the application name
• <APP_SHORT_DESCRIPTION>: a quick app description
• <APP_CATEGORY>: the app category (used in the cozy-bar apps navigation)
• <APP_MAINTAINER>: Github main maintainer username (don't forget @ :))
• <SLUG_TX>: transifex app slug
• <SLUG_GH>: Github repository slug
• <SLUG_NPM>: NPM slug
• <USERNAME_GH>: Github username

Don't forget to update your LICENSE too if needed.

⚠️ Concerning the application category, for now just cozy and partners are handled. Other categories will be handled soon, for now, you can let this field blank, it will be in the others category. If a category is empty, missing or not recognized, it will be others by default.

Step 3: add your own repository

Go to https://github.com/new and create a new repository for your app. Then add it to your app:

$ git remote add \
  origin \
  https://github.com/<USERNAME_GH>/<SLUG_GH>.git
$ git commit -am "Initial commit for my-app"
$ git push -u origin master:master

That's it 🚀!

Congrats! Your app is now fully set. You can start coding in src, and run it through a cozy-stack.

You can find more informations about how to bootstrap a Cozy app in the Cozy's app bootstrap^v3 talk.

Community

Maintainer

The lead maintainer for cozy-template and tooling is @m4dz, send him a 🍻 to say hello!

Get in touch

You can reach the Cozy Community by:

• Chatting with us on IRC #cozycloud on Freenode
• Posting on our Forum
• Posting issues on the Github repos
• Say Hi! on Twitter

License

cozy-template is developed by Cozy Cloud and distributed under the AGPL v3 license.