This is the front-end service that runs ewgf.gg. It is designed to visualize and display TEKKEN 8 data that has been collected from the Wavu Wank api.
Note: To run this locally, you MUST have the backend server running at the configured API_URL before starting the frontend application. See the backend repository for setup instructions.
- Node.js (v18 or higher)
- npm
-
Clone the repository
git clone https://github.com/ewgf-gg/ewgfgg-frontend.git
-
Install dependencies
npm install
-
Set up environment variables Create a
.envfile in the root directory with the following variables:API_URL=http://localhost:8080 -
Start the development server
npm run dev
├── app/ # Next.js app directory
│ ├── api/
│ ├── player/ # Player profile page
│ ├── statistics/ # Statistics page
│ ├── state/
│ │ ├── atoms/ # Jotai atoms
│ │ └── types/ # Type definitions
├── components/
│ ├── homepage-charts/ # Chart Components for the homepage
│ ├── player-charts/ # Chart Components for player statitics page
│ ├── player-stats/ # Components for player statistics page
│ ├── shared/ # Shared generic components
│ ├── statistics/ # Statistics page components
│ └── ui/ # Shared UI components
├── lib/ # Utility functions and API clients
│ └── hooks/ # Custom React hooks
├── static/ # Static assets
│ ├── character-icons/ # Character icons
│ ├── rank-icons/ # Rank icons
│ └── tekken-inputs/ # Tekken input icons
- Next.js
- TypeScript
- React
- Jotai
- Recharts
- Framer Motion
- Tailwind CSS
- shadcn/ui
The frontend communicates with the backend API that provides the following endpoints:
/player-stats/{polarisId}- Get detailed stats for a specific player/player-stats/search- Search for players by name or TEKKEN-ID/statistics/stats-summary- Get summary statistics (total players, replays)/statistics/top-winrates- Get top 5 character win rates/statistics/top-popularity- Get top 5 character popularity/statistics/winrate-changes- Get character win rate changes/statistics/rankDistribution- Get rank distribution data/statistics/version-popularity- Get character popularity by game version/statistics/version-winrates- Get character win rates by game version
Contributions are appreciated and welcome! Please feel free to submit a pull request :)
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the GNU General Public License v3.0 (GPL-3.0).