Home Features Setup Guide Documentation FAQ GitHub

Overview

Discover what SWAT includes, how its workflow fits together, and why it is designed as a practical starting point for real Symfony projects.

What is SWAT

SWAT is a lightweight Symfony starter designed to help you launch a modern project with a clean structure, a minimal frontend stack and a ready-to-use CI/CD pipeline.

Its goal is not to provide a rigid framework or an overengineered architecture, but a practical, production-ready foundation that developers can understand quickly, use immediately and adapt to their own needs.

How SWAT works
โš™๏ธ

1. Develop

Build your Symfony application locally with Twig, SCSS, TypeScript and a structure that stays simple and readable.

๐Ÿงช

2. Validate

GitHub Actions validates the project by installing dependencies, running checks, executing tests and preparing the build.

๐Ÿš€

3. Deploy

SWAT deploys the application over SSH using environment-specific secrets and a workflow adapted to your hosting strategy.

๐Ÿ–ฅ๏ธ

4. Run

The target server runs the application with its own environment variables, deployment settings and infrastructure constraints.

Main components
โš™๏ธ

Symfony application

The backend handles routing, controllers, templates and application logic through a clean and conventional Symfony structure.

๐ŸŽจ

Frontend stack

Twig, SCSS, TypeScript and Turbo provide a modern frontend foundation without introducing unnecessary complexity.

๐Ÿš€

GitHub Actions pipeline

The CI/CD workflows validate, build and deploy the project automatically through GitHub Actions.

๐Ÿ–ฅ๏ธ

Server environment

Environment variables, SSH access and deployment-specific server configuration complete the production workflow.

Design philosophy

Minimal by design

SWAT focuses on the common essentials needed to start a project, without turning the starter into an all-in-one framework.

Developer-first

The codebase is meant to stay readable, practical and easy to appropriate, even when you need to adapt it to your own workflow.

Production-ready

SWAT is designed around real validation and deployment workflows, not just local development.

Flexible

SWAT covers the shared foundation, while project-specific infrastructure and business needs remain intentionally outside the starter.

What next?

Continue with the technical documentation to explore the CI/CD pipeline, the project structure and the available customization options in more detail.