Welcome to FC-TeamForge, your ultimate solution for effortlessly creating balanced football teams from a pool of real-life players. This application streamlines team formation, ensuring fair and exciting games every time.
- Dynamic Player Database:
- Manage a database of real players, such as your friends, and organize your football squad.
- Smart Team Generator:
- Automatically create balanced teams with the click of a button.
- Formation Flexibility:
- Select from various formations to suit your strategy and maximize performance.
- Substitute Management:
- Keep the game dynamic by selecting substitutes as needed.
- User-Friendly Interface:
- An intuitive design ensures that even non-tech-savvy users can navigate the app effortlessly.
- Responsive Design (Planned):
- Future updates will include seamless functionality across mobile, tablet, and desktop devices.
- Frontend: Vue.js with Vite
- Backend: Node.js, Express.js, MySQL (for player database management)
- Styling: CSS (static stylesheets)
- Icons and Graphics: Font Awesome and external assets
- Responsive Design: Ensure the app is mobile-friendly.
- FIFA Card-like Graphics: Improve player visuals.
- Player Ranking System: Add rankings based on frequency of play.
- Database of Formations: Expand and customize team formations.
Clone the repository:
git clone https://github.com/TharunKumarrA/FC-TeamForge.git
cd FC-TeamForge/frontendnpm installThe frontend depends on a backend server for player management and team formation.
- Clone the backend repository:
git clone https://github.com/Thanus-Kumaar/FC-TeamForge-server.git- Install backend dependencies:
npm install- Start the backend server:
node server.jsEnsure the backend server is running before starting the frontend. Run Frontend Locally
- Start the development server:
npm run devA detailed guide for integrating the backend has been provided by @thecodingvivek. It covers all aspects of the backend setup, API integration, and interaction with the database.
- Add Players: Navigate to the "Add Player" screen and input player details.
- Select Players: Choose players for the game from the database.
- Generate Teams: Select a formation, and let the app divide players into balanced teams.
- Manage Substitutes: Add substitutes to ensure everyone gets playtime.
- Initial View: Upon entering the app, users will see a dashboard prompting them to select at least 6 players. Filters and a search bar are available to assist in player selection.
- Filters: Filter players by their roles (A: Attacker, M: Midfielder, D: Defender, G: Goalkeeper).
- Search: Search for players by name.
- Select Players: Add players to the "Selected Players" section to proceed with team formation.
- Choose Formation: Once the minimum player count is met, proceed to select a formation.
- Generate Teams: Click "Form Teams" to generate two balanced teams based on the selected formation.
- Review and Adjust: Adjust players or formations as needed.
TharunKumarrA-FC-TeamForge/
├── frontend/
│ ├── index.html
│ ├── public/
│ │ ├── images/
│ │ ├── constants.js
│ ├── src/
│ │ ├── components/
│ │ │ └── NewPlayer.vue
│ │ ├── static/
│ │ ├── App.css
│ │ └── NewPlayer.css
│ └── main.js
├── Docs/
│ └── Design.md
└── backend/
├── server.js
├── Algorithm.js
├── sqlconnect.js
├── nodemon.json
├── package.json
└── README.md
We welcome contributions from the community! To contribute:
- Fork the repository.
- Create a new branch:
git checkout -b feature-name
- Make your changes and commit them:
git commit -m "Add your message here" - Push to your branch
git push origin feature-name
- Create a new PR to main
Feel free to open issues for bugs, feature requests, or questions.
- Mobile and tablet responsiveness.
- Enhanced graphics and player profiles.
- Additional database features for formations and substitutes.
- Ranking and statistics for players.
This project is licensed under the MIT License.
