amranich.dev

My personal portfolio website, built to showcase my work and skills as a software developer.

Visit Website | Changelog | Report Bug

Features

• Fully responsive design
• Support for non-JavaScript clients
• Multilingual support (English and French)
• Contact form with PHPMailer and Google reCAPTCHA
• Custom 404/500 error pages
• SEO optimized metadata and Open Graph support
• Automated CI/CD deployment using GitHub Actions
• Hosted on AWS Lightsail with Nginx and vsftpd (FTPS)

Tech Stack

Frontend

• Tailwind CSS
• Vanilla JavaScript

Backend

• Jigsaw - PHP static site generator
• PHPMailer - Email sending via SMTP

Deployment

• AWS Lightsail (Debian)
• Nginx
• vsftpd with SSL/TLS
• GitHub Actions

Setup

Prerequisites

• PHP 8.0+
• Composer
• Node.js 14+
• npm

Installation

git clone https://github.com/AmraniCh/amranich.dev.git
cd amranich.dev

composer install
npm install

Development

npm run watch    # dev server with hot reload
npm run dev      # development build
npm run prod     # production build

Build output goes to build_production/.

Environment Variables

Copy source/backend/env.example to source/backend/.env:

cp source/backend/env.example source/backend/.env

Update with your credentials:

SMTP_FROM_ADDRESS=
SMTP_TO_ADDRESS=
SMTP_HOST=
SMTP_PORT=
SMTP_USERNAME=
SMTP_PASSWORD=
RECAPTCHA_SECRET=

Deployment

Push to the repo or create a tag, GitHub Actions builds and deploys via FTPS. See .github/workflows/deploy.yml.

License

This project's code is released under the MIT License.

If you're interested in building a similar website or need help, feel free to reach out at contact@amranich.dev.