42term is a web application that generates beautiful terminal-style widgets to showcase 42 school students' profiles, projects, and skills. These widgets can be embedded in GitHub READMEs, personal websites, or anywhere that supports SVG images.

• Multiple Widget Types:

  • Profile Widget: Display student information, level, and statistics
  • Projects Widget: Showcase completed projects with marks
  • Skills Widget: Visualize coding skills and proficiency levels

• Customization:

  • Dark and Light themes
  • Adjustable width
  • Downloadable SVG files

• Easy Integration:

  • Direct URL embedding
  • Markdown for GitHub READMEs
  • HTML for websites

The easiest way to generate your widget is to visit 42term and follow these steps:

1. Enter your 42 intra username
2. Select the widget type (Profile, Projects, Skills)
3. Choose your preferred theme
4. Copy the generated markdown or HTML code

Add this to your GitHub README to display your widget:

![username's 42 profile](https://42term.vercel.app/api/widget/student/username?theme=dark)

Replace username with your 42 intra username, and choose the widget type:

• student for profile widget
• projects for projects widget
• skills for skills widget

![zelhajou's 42 profile](https://42term.vercel.app/api/widget/student/zelhajou?theme=dark)

![zelhajou's 42 projects](https://42term.vercel.app/api/widget/projects/zelhajou?theme=dark)

![zelhajou's 42 skills](https://42term.vercel.app/api/widget/skills/zelhajou?theme=dark)

• theme: dark or light (default: dark)
• width: Width in pixels (default: 800)
• maxSkills: Maximum skills to display for skills widget
• maxProjects: Maximum projects to display for projects widget
• includePiscine: Include Piscine projects (true/false)

• Node.js 18+
• Yarn or npm

1. Clone the repository:

git clone https://github.com/zelhajou/42term.git
cd 42term

2. Install dependencies:

npm install
# or
yarn

3. Create a .env file with your 42 API credentials:

NEXT_PUBLIC_42_API_URL="https://api.intra.42.fr/v2"
FT_CLIENT_SECRET="your-client-secret"
FT_CLIENT_ID="your-client-id"

4. Run the development server:

npm run dev
# or
yarn dev

5. Open http://localhost:3000 in your browser.

• Next.js 15 - React framework
• TailwindCSS - Styling
• 42 API - Data source
• SVG - Widget rendering

Contributions are welcome! Feel free to submit issues or pull requests to help improve 42term.

This project is open source and available under the MIT License.

Created with ❤️ by Zelhajou, a 1337 (42 Network) student. Not officially affiliated with 42 School.