Retrospectives made fast - An open source retrospective tool for agile teams.
Dreading your next retro again? Cringe icebreakers, pointless fluff and going overtime (again)? Yeah, same here. That's why we built Fast Retro: Wrap up your next retro fast, getting actionable results and get back to work.
- 🎯 Two Simple Columns: Just "What went well?" and "What could be better?" - no confusing categories or endless options
- 🤝 Smart Grouping & Voting: Group similar feedback together, then vote on what matters most with 3 votes per person
- 🔄 Real-time Collaboration: See feedback appear instantly as team members contribute
- ⚡ Fast Setup: Create and start a retrospective in seconds - no signup required
- 🔓 Open Source: Free forever, modify as you like, no vendor lock-in
- PHP 8.1 or higher
- Node.js 18 or higher
- Composer
- npm or yarn
-
Clone the repository
git clone https://github.com/JangoCG/fastretro.git cd simple-retro-vue -
Install PHP dependencies
composer install
-
Install Node.js dependencies
npm install
-
Environment setup
cp .env.example .env php artisan key:generate
-
Database setup
touch database/database.sqlite php artisan migrate --seed
-
Start development servers
composer dev
That's it! Open your browser to http://localhost:8000 and start your first retrospective.
- Laravel 12 - Modern PHP framework with Inertia.js for SPA-like routing
- Laravel Reverb - WebSocket server for real-time collaboration
- SQLite - Lightweight database for development
- Pest PHP - Testing framework
- Vue 3 - Progressive JavaScript framework with Composition API
- TypeScript - Type-safe JavaScript development
- Tailwind CSS v4 - Utility-first CSS framework
- ShadCN/UI - High-quality component library
- Vite - Fast build tool and development server
- Real-time updates via WebSocket broadcasting
- Session-based authentication for anonymous participation
- Drag & drop feedback organization
- Type-safe Laravel-to-TypeScript integration
- Mobile-first responsive design
# Backend
composer dev # Start all services (Laravel, queue, WebSocket, logs, Vite)
composer test # Run Pest PHP tests
php artisan migrate # Run database migrations
# Frontend
npm run dev # Vite development server
npm run build # Production build
npm run lint # ESLint with auto-fix
vue-tsc # TypeScript checking
npm run format # Prettier formatting
# Type Generation
npm run typegen # Generate TypeScript types from Laravel models
php artisan wayfinder:generate # Generate TypeScript route definitions├── app/ # Laravel application code
│ ├── Events/ # WebSocket broadcast events
│ ├── Http/Controllers/ # API controllers
│ └── Models/ # Eloquent models
├── resources/
│ ├── js/ # Vue.js frontend
│ │ ├── components/ # Reusable Vue components
│ │ ├── layouts/ # Layout components
│ │ ├── pages/ # Inertia.js pages
│ │ └── composables/ # Shared reactive logic
│ └── views/ # Blade templates
├── database/
│ ├── migrations/ # Database schema
│ └── seeders/ # Test data
└── tests/ # Pest PHP tests
Fast Retro follows a structured 6-phase workflow:
- WAITING - Participants join the session
- BRAINSTORMING - Team members add feedback to two columns
- THEMING - Group similar feedback items together
- VOTING - Vote on the most important topics (3 votes per person)
- DISCUSSION - Talk through the highest-voted items
- SUMMARY - Review action items and next steps
I love contributions! Please see our Contributing Guide for details on how to get started.
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature - Make your changes and add tests
- Commit your changes:
git commit -m 'Add amazing feature' - Push to the branch:
git push origin feature/amazing-feature - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
Third-party dependencies are licensed under their respective licenses. See THIRD-PARTY-LICENSES.md for details.