amFOSS Website

The amFOSS Website is an archived Next.js-powered JAMStack website template for FOSS@Amrita (amFOSS), a free and open source software club at Amrita University, that provides a complete local development and Surge deployment workflow.

What is the amFOSS Website?

The amFOSS Website is the official website for FOSS@Amrita, built with Next.js and the JAMStack architecture. It takes a Next.js project structure and produces a static site ready for deployment via Surge.sh, with the source code openly available under an MIT license. The project is archived and no longer actively maintained, but it remains available as a reference for building club websites.

Key Features

• Next.js framework — Built on Next.js, the React-based framework for server-rendered and static web applications.
• JAMStack architecture — The site is designed as a JAMStack project (JavaScript, APIs, and Markup) for fast static delivery.
• Surge deployment — Includes documented steps for deploying to Surge.sh, including GitLab CI/CD variables (SURGE_TOKEN and SURGE_LOGIN) for automated pipelines.
• MIT license — Released under the MIT open source license, permitting free use and modification.
• Local development server — Provides a standard npm setup where npm install and npm run dev start a development server at localhost:8000.

Who is it for?

• FOSS clubs at universities — Use the codebase as the starting point for their own community website, since it already contains the club's branding and structure.
• Next.js learners — Study a real-world Next.js project that also demonstrates JAMStack and CI/CD deployment patterns.
• Open source contributors — Fork and extend the archived repository for learning purposes or to revive a club site with modern updates.

What can you do with the amFOSS Website?

• Student organizations: Deploy a club website to Surge.sh using the provided environment variable setup in GitLab CI/CD.
• Frontend developers: Run the site locally with npm run dev and modify the Next.js components and styles.
• FOSS communities: Use the MIT-licensed source as a template for creating a new JAMStack site with a similar structure.

How does the amFOSS Website work?

To run it locally, install Node.js and NPM, clone the repository, run npm install, and then npm run dev to serve the site at localhost:8000. For deployment, create a Surge.sh account, run surge in the project root, and configure SURGE_TOKEN and SURGE_LOGIN as GitLab CI/CD variables for automated publishing.

FAQ

Is the amFOSS Website free to use?

Yes, the project is available under the MIT license, so you can freely use, copy, modify, and distribute it with attribution.

How do I run it locally?

After installing Node.js and NPM, clone the repository and run npm install followed by npm run dev. The site will be available at http://localhost:8000.

Is this template still maintained?

No, the repository is archived and no longer actively maintained. It is kept for reference purposes only.

What deployment platform does it use?

The documentation describes deploying to Surge.sh, and GitLab CI/CD variables are used to automate the process.