amFOSS Events

A centralized repository for landing pages of amFOSS events

amFOSS Events (events.amfoss.in) serves as the centralized repository and entry point for all recent and upcoming events organized by amFOSS. It hosts the source code and content for the landing pages of events, allowing members to manage, update, and track event-related materials in a version-controlled environment.

Tech Stack

• Frontend:
  • React
  • Tailwind CSS

How It Works

• Each event gets its own configured landing page with registration forms and event details.
• Registration data is stored through external APIs connected to spreadsheet backends.
• The platform includes fallback mechanisms to ensure pages load even when JavaScript fails.

Getting Started

Prerequisites

• Node.js (v16 or higher recommended)
• npm or yarn

Installation & Running

1. Clone this repository:

   git clone https://github.com/amfoss/Club-Events-Portal.git
   cd Club-Events-Portal

2. Start the development server:

   npm install
   npm start  

Event Configuration

Each event can be configured by:

• Content Updates: Modify components in src/components/ for event-specific information.
• Styling: Update CSS and Tailwind classes for event branding.
• Registration Logic: Configure API endpoints and validation rules in registration forms.
• Assets: Replace images and logos in public/assets/ directory.

Contributing

Adding New Events

1. Fork the repository for the new event.
2. Update content in components.
3. Configure registration endpoints and validation.
4. Test and submit a pull request.

Deployment

The portal is hosted at events.amfoss.in.

Events are automatically deployed via GitHub Actions:

1. Automatic: Push to the main branch triggers deployment
2. Manual: Run npm run deploy for immediate deployment.
3. Custom Domains: Configure in repository settings.