✦ Contribuer

Rejoignez le
projet Suddenly

Suddenly est un logiciel libre. Toutes les contributions sont les bienvenues — code, documentation, traductions, tests, design.

Comment contribuer

Choisissez votre voie

💻
Code
Corrigez des bugs, ajoutez des fonctionnalités. Python 3.11+, Django 5, ActivityPub.
Voir les issues
📝
Documentation
Améliorez la documentation technique ou rédigez des guides utilisateur.
Voir la doc
🌍
Traductions
Aidez à traduire Suddenly dans votre langue.
Contribuer
🐛
Signaler des bugs
Testez Suddenly et signalez les problèmes que vous rencontrez.
Ouvrir une issue

Stack technique

La technologie derrière Suddenly

🐍
Python 3.11+
Langage principal du backend
🎸
Django 5
Framework web, rendu côté serveur
🐘
PostgreSQL 16
Base de données — la seule dépendance obligatoire
HTMX + Alpine + UnoCSS
Interface sans SPA, ~32 Ko
🌐
ActivityPub
Protocole de fédération, signatures HTTP
Redis + Celery
Cache et tâches asynchrones — optionnels, fallback intégré

Environnement de développement

Démarrer en local

1
Cloner et configurer
git clone https://github.com/RebelliousSmile/suddenly.git
cd suddenly
cp .env.example .env
2
Lancer avec Docker
docker compose -f docker-compose.dev.yml up
3
Initialiser la base
docker compose -f docker-compose.dev.yml exec web python manage.py migrate
docker compose -f docker-compose.dev.yml exec web python manage.py createsuperuser