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.
This repository is a client-side app skeleton for Cozy Cloudv3. We keep it up-to-date with our habits and best-practices. It allow you to bootstrap an app from scratch in a breeze.
$ git clone \
--origin=template \
--depth=1 \
https://github.com/cozy/cozy-template.git \
my-app
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_PORT>
: app running port<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.
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 add -am "Initial commit for my-app"
$ git pull -u origin master:master
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 bootstrapv3 talk.
The lead maintainer for cozy-template and tooling is @m4dz, send him a 🍻 to say hello!
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
cozy-template is developed by Cozy Cloud and distributed under the AGPL v3 license.