Repository navigation
Developer Setup
Welcome to the technical implementation guide for L7OT (الحوت).
- Frontend Framework: React 19 + TypeScript 5
- Build Tooling: Vite 8.x + Rollup
-
Styling Engine: Tailwind CSS v4 +
@tailwindcss/vite -
Typography:
@fontsource/amiri,@fontsource/ibm-plex-sans-arabic,@fontsource-variable/fraunces,@fontsource-variable/jetbrains-mono -
Iconography:
lucide-react -
Audio Synthesizer: Pure Web Audio API (
SoundEnginewith oscillator nodes, biquad filters & gain envelopes) -
Testing: Vitest 5.x +
@testing-library/react+jsdom(26/26 tests passing) -
Containerization: Multi-stage Docker build with
node:22-alpine&nginx:alpine - Cloud & Edge Hosting: Netlify Edge CDN & GitHub Pages
- Production URL: https://l7ot-morocco.netlify.app
- GitHub Repository: https://github.com/Bosaj/l7ot
git clone https://github.com/Bosaj/l7ot.git
cd l7otnpm installnpm run devThe server will start at http://localhost:5173/.
L7OT maintains complete unit and integration test coverage:
# Run all tests once
npm run test
# Run tests in watch mode
npm run test:watch# Strict TypeScript validation
npm run typecheck
# Full production build
npm run buildL7OT is fully containerized with a production multi-stage Dockerfile and docker-compose.yml:
# Build the Docker image
docker build -t l7ot:latest .
# Run the container exposing port 8080
docker run -d -p 8080:80 --name l7ot-app l7ot:latestdocker compose up -dThe application is now accessible at http://localhost:8080/ with:
- Nginx alpine web server with gzip compression.
- Immutable 1-year browser cache headers for static assets.
- Full SPA fallback routing (
try_files $uri $uri/ /index.html =404;). - Content Security Policy & Security headers (
X-Frame-Options,X-Content-Type-Options,Referrer-Policy).
-
GitHub Actions CI Pipeline (
.github/workflows/ci.yml):- Runs on every push and pull request to
main. - Executes strict
tsc -b, Vitest test suite, and productionvite build.
- Runs on every push and pull request to
-
CodeQL Security Analysis (
.github/workflows/codeql.yml):- Deep AST static analysis for CWE vulnerabilities.
-
Deploy to GitHub Pages (
.github/workflows/deploy-pages.yml):- Deploys production bundle directly to GitHub Pages upon push to
main.
- Deploys production bundle directly to GitHub Pages upon push to
-
Netlify Automated Edge CDN:
- Configured via
netlify.tomlandpublic/_redirects. - Instant global caching and zero-downtime atomic deployments.
- Configured via
L7OT (الحوت) — The Definitive Moroccan Fish & Marine Encyclopedia
Curated & Architected by Oussama EL HADJI • Distributed under the MIT License
-
📖 Encyclopedia & Biology
-
🍽️ Culinary & Port Culture
-
📊 Economics, Treaties & Maritime Law
-
💻 Engineering & Architecture