linagora /twake-drive

Twake Drive Web App

★ 997⑂ 165👁 20⑃ 4,135● 467▤ 509
JavaScriptAGPL-3.0Created 2016-12-11twake-drive.com
Download: 1.108.01.108.0 ↓1.108.02026-10-22
+0
Daily
997
stars
165
forks
20
watchers
4,135
prs
467
issues
509
releases

README

Twake Drive


  
   
   
  
  
    The open-source alternative to Google Drive.
    
    Learn more »
    
    
    Website
    |
    Issues
  


 About



 What's Drive?

Twake Drive makes your file management easy. Main features are:

- File tree
- Files and folders upload.
- Files and folders sharing (via URLs)
- Files and folders search

 Getting Started

_:pushpin: Note:_ [Yarn] is the official Node package manager of Twake Drive. Don't hesitate to [install Yarn][yarn-install]

 Install

Starting the Drive app requires you to [setup a dev environment][setup].

You can then clone the app repository and install dependencies:

sh
$ git clone https://github.com/linagora/twake-drive.git
$ cd twake-drive
$ yarn install


:pushpin: Don't forget to set the local node version indicated in the .nvmrc before doing a yarn install.

Twake Drive use a standard set of _npm scripts_ to run common tasks, like watch, lint, test, build…

 Run in dev mode

Using a watcher - with Hot Module Replacement:

sh
$ cd twake-drive
$ yarn watch
$ cozy-stack serve --appdir drive://twake-drive/build/drive --disable-csp


Or directly build the app (static file generated):

sh
$ cd twake-drive
$ yarn build
$ cozy-stack serve --appdir drive://twake-drive/build/drive


Your app is available at http://drive.cozy.localhost:8080//folder

Note: it's mandatory to explicit to cozy-stack the folder of the build that should be served, to be able to run the app.

 Run it inside the VM

You can view your current running app, you can use the [cozy-stack docker image][cozy-stack-docker]:

sh
 in a terminal, run your app in watch mode
$ cd twake-drive
$ yarn watch


sh
 in another terminal, run the docker container
$ docker run --rm -it -p 8080:8080 -v "$(pwd)/build/drive":/data/cozy-app/drive cozy/cozy-app-dev


Your app is available at http://drive.cozy.tools:8080.

 Advanced case

 Share and send mails in development

Twake Drive let users share documents from twake to twake.

Meet Alice and Bob.
Alice wants to share a folder with Bob.
Alice clicks on the share button and fills in the email input with Bob's email address.
Bob receives an email with a _« Accept the sharing »_ button.
Bob clicks on that button and is redirected to Alice's twake to enter his own twake url to link both twakes.
Bob sees Alice's shared folder in his own twake.

🤔 But how could we do this scenario on binary cozy-stack development environment?

If you develop with the cozy-stack CLI, you have to run MailHog on your computer and tell cozy-stack serve where to find the mail server with some options:


./cozy-stack serve --appdir drive:../twake-drive/build --mail-disable-tls --mail-port 1025


_This commands assumes you git clone twake-drive in the same folder than you git clone cozy-stack._

Then simply run mailhog and open http://cozy.tools:8025/.

 Retrieve sent emails

With MailHog, every email sent by cozy-stack is caught. That means the email address _does not have to be a real one_, ie. bob@cozy, bob@cozy.

Top issues

Latest release

1.108.0 1.108.0 2026-10-22
Releasing Twake Drive 1.108.0 to production:

 New features

 Shared drives and sharing

- With federated sharing enabled, you can share folders nested inside shared folders. Drive asks for confirmation when reducing access also affects a parent folder. (4182, 4196)
- Accept or decline sharing invitations from a banner without leaving Drive. Invitations appear one at a time, and unrelated banners are hidden on sharing pages. (4289, 4399, 4309)

 Moving and choosing files

- Browse destinations and create folders in the move dialog, including folders shared with you where you have write access.

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON