Welcome to the Calisthenics Challenges Platform, a web application designed to promote fitness through exciting and engaging challenges. Users can join challenges, upload their results, and earn points while competing with others.
- Join Active Challenges: Browse and join currently active challenges.
- Upload Results: Submit your results for approval and track your performance.
- View Progress: See your status and whether your results are approved or pending.
- Admin Management: Admins can create, edit, and delete challenges and manage their statuses.
- Explore Challenges: View active and previous challenges.
- Call to Action: Encouraged to register or log in to participate and upload results.
- Framework: Laravel
- Frontend: TailwindCSS for modern and responsive design
- Database: MySQL (Eloquent ORM)
- Authentication: Laravel Breeze
- Icons: Font Awesome
-
Clone the Repository
git clone https://github.com/WorkoutKing/Calisthenics-Page.git cd calisthenics-challenges
-
Install Dependencies
composer install npm install
-
Set Up Environment
- Copy the
.env.example
file and rename it to.env
:cp .env.example .env
- Configure the
.env
file with your database credentials and other settings.
- Copy the
-
Generate Application Key
php artisan key:generate
-
Migrate and Seed the Database
php artisan migrate --seed
-
Build Assets
npm run build
-
Start the Server
php artisan serve
Visit the application at http://localhost:8000
.
- Register an Account: Sign up to start participating in challenges.
- Join Challenges: Explore active challenges and join the ones that interest you.
- Upload Results: Submit your performance to earn points and track your progress.
- Admin Panel: If you’re an admin, manage challenges and their statuses.
app/
: Core application files (Controllers, Models, Middleware).resources/views/
: Blade templates for frontend pages.routes/
: Web routes defined inweb.php
.public/
: Publicly accessible assets (compiled CSS/JS).database/
: Migrations, seeders, and factories.
- Fork the repository.
- Create a new branch for your feature or bug fix.
- Commit changes and push to your branch.
- Open a pull request to the main branch.
This project is licensed under the MIT License.
For questions, feedback, or support:
- Email: madstars4ever@gmail.com
- GitHub: https://github.com/WorkoutKing