Croodle logo

Croodle

  •  0 ratings
In category: Polls and Events

About Croodle

Croodle is an end-to-end encrypted web application to schedule a date or to do a poll on any topic.

  •   363  
  •   0  
  •   0  
  •   0  
Github stats:
  •  Commits: 1,191  
  •   124  
  •   25  
  •  Latest commit: Jan 27, 2021  

Deploy this app to Linode with a free $100 credit!

Languages/Platforms/Technologies:
Lincenses:

More about Croodle

Croodle

Build Status Code Climate devDependency Status

Croodle is an end-to-end encrypted web application to schedule a date or to do a poll on a any topic. All data like title, description, number and labels of options, available answers and names of users and their selections are encrypted/decrypted in the browser using strong 256-bit AES encryption.

This is an alpha version. Changes could brake backward compatibility. It is also not well tested and some features are missing. It is not meant for productive use yet.

Croodle is inspired by PrivateBin and, of course, by Doodle.

Security notice

As any other web application based end-to-end encryption Croodle could be attacked by an injection of malicious code on serverside or threw a man-in-the-middle attack. If an attacker could inject for example JavaScript, they would be able to read the decrypted content in the browser or the encryption key that is used used and exfiltrate that data.

Therefore you have to:

  • use an encrypted connection to the server hosting Croodle. In most use cases this will be an HTTPS connection. We strongly recomend people hosting Croodle to force an encrypted connection.
  • trust the server.

Theoretically you could also check for an attack like this by analysing the source code retrieved from server and/or using developer tools of your browser and check what data is send over the network or stored in cookies, local storage or similar browser techniques.

Requirements

Croodle is designed to have as few as possible requirements on the server it is running on. Croodle runs on almost every web space with PHP >= 5.6. Croodle stores the data in textfiles, so there is no need for a database server like MySQL.

Due to security reasons you should have TLS encryption enabled and provide a valid certificate. (see the security notice)

Build process and installation

Production builds are provided as github release assets.

If you like to build yourself you have to install yarn, ember-cli and composer before.

git clone git@github.com:jelhan/croodle.git
cd croodle
yarn install
cd api/ && composer install --no-dev && cd ..
yarn build --prod

Afterwards copy all files in /dist folder to your werbserver.

Configuration

The API can be configured by creating a config.php inside api/ folder which returns an associative array. Have a look at api/config.default.php for available options.

Webserver configuration

  • data/ folder has to be writeable by web server, but must not be accessible publicly. Protect it in your webserver configuration or move it out of webroot by changing dataDir api option.
  • Croodle uses subresource integrity (SRI) for assets. Therefore you must not tamper with build output (e.g. you have to disable cloudflare Auto Minify feature). If that's not an option for you, you have to disable SRI and build yourself.
  • HTTPS connection should be forced. You should consider using HTTP Strict Transport Security (HSTS) and HTTP Public Key Pinning (HPKP).
  • Content-Security-Policy (CSP) and Referrer-Policy headers should be used. Default headers are provided in .htaccess file but commented out.
  • Execute php api/cron.php on a regular basis to delete outdated polls. A cronjob running once a day should be fine.

Development

ember serve generates a development build of Croodle and starts a server listening on http://localhost:4200 which is serving it. If source files are changing, a rebuild and reload is triggered.

By default Croodle uses an api mock in development. Since that one does not persist records all polls are gone after a reload.

If you like to test against the real API, run api via php built-in web server: php -S 127.0.0.1:8080 -t dist/ Afterwards start ember-cli development server using --proxy option: ember server --proxy http://127.0.0.1:8080.

Ember-cli clears dist folder on each rebuild. If you like to keep created polls over rebuild, configure api to use a non default folder to save your polls: CROODLE__DATA_DIR=/tmp/croodle_data php -S 127.0.0.1:8080 -t dist/

Running tests

Ember

ember test --server is the prefered way to run tests in Chrome. Results are reported in command-line and browser. Files are watched for changes.

If you like to run tests only once in a headless Chrome and Firefox execute ember test. This is also used in CI.

Additionally tests are available in all development builds. This allows you to execute the tests in any browser of your choice by running ember serve and opening http://locahost:4200/tests.

Tests are run against a mock-api provided by ember-cli-mirage. Therefor they don't cover system integration.

API

API tests are provided by Codeception. To run them change current directory to /api and execute ./vendor/bin/codecept run. You have to install composer development requirements before (composer install without --no-dev option).

Credits

Continous Integration powered by

Cross-browser testing provided by

License

Croodle is MIT Licensed.

Comments (0)

Please login to join the discussion on this project.

Croodle Reviews (0)

Overall Rating

None

based on 0 ratings

Please login to review this project.

No reviews for this project yet.

↑ back to top

Linux VPS from $11/yr.
RackNerd VPS for $11.38/mo

Popular Projects

FluxBB

in Social Networks and Forums
 31k    0    0    0  

Nextcloud

in File Transfer & Synchronization
 19k    1    1    0  

Libreddit

in Social Networks and Forums
 6k    0    1    0  

CasaOS

in Self-hosting Solutions
 5k    0    0    0  

Audiobookshelf

in Audio Streaming
 5k    0    1    0  

Mediagoblin

in Photo and Video Galleries
 4k    0    0    0  

Dashboard

in Personal Dashboards
 4k    0    0    0  

Most Discussed

Nextcloud

in File Transfer & Synchronization
 19k    1    1    0  

Tube Archivist

in Automation
 3k    0    1    0  

OneDev

in Project Management
 2k    0    0    0  

iodine

in Proxy
 2k    0    0    0  

Alf.io

in Booking and Scheduling
 2k    0    0    0  

sysPass

in Password Managers
 929    0    0    0  

Misskey

in Social Networks and Forums
 2k    0    0    0  
pCloud Lifetime

Top Rated Projects

Gitea

 1 rating
in Project Management

Bagisto

 1 rating
in E-commerce

LinkAce

 1 rating
in Bookmarks and Link Sharing

Pydio

 1 rating
in File Transfer & Synchronization

Audiobookshelf

 1 rating
in Audio Streaming

Nextcloud

 1 rating
in File Transfer & Synchronization

Seafile

 1 rating
in File Transfer & Synchronization

Categories

You May Also Be Interested In

dudle logo
dudle cover

dudle

Online scheduling application.

JD Esurvey logo
JD Esurvey cover

JD Esurvey

Open source enterprise survey web application.

Calagator logo
Calagator cover

Calagator

Event aggregator.