Skip to content

README.md

Latest commit

 

History

History
450 lines (333 loc) · 22.3 KB

README.md

File metadata and controls

450 lines (333 loc) · 22.3 KB
Raw

⚡ sunmeat.dev

Oleksandr Zahoruiko

Android & Full-Stack Developer · IT Lecturer

Designing and building thoughtful digital products, native Android applications, and web experiences.

Portfolio GitHub npm

UK flag English · Russian flag Русский · French flag Français

Preview of the sunmeat.dev portfolio

Independent projects. Practical engineering. A lifelong love of teaching.

UK flag English

Overview

sunmeat.dev is my personal portfolio and a living showcase of the things I build. It brings together my work in full-stack development, native Android, education, and independent product experiments in one carefully designed space.

The interface combines a dark, terminal-inspired aesthetic with a clear responsive layout. The repository is also documented to make its structure, design decisions, maintenance, and deployment easier to understand.

At a glance

14 5+ 19+ 247
Sites & projects Android apps Years in software & teaching GitHub repositories

Portfolio figures reflect the currently published profile and may change over time.

What you'll find

  • A professional profile: background, experience, skills, and contact links.
  • Android applications: published apps with links to their Google Play listings.
  • Web projects: live websites and selected independent experiments.
  • A technical overview: languages, frameworks, platforms, and development tools.
  • An interactive profile card: comments powered by Firebase / Firestore.
  • A responsive interface: layouts designed for mobile, tablet, and desktop.
  • Discoverability and insights: SEO metadata, Open Graph previews, structured data, and Vercel Web Analytics.

Technology

Area Tools
Frontend React 19, JavaScript, Vite
Styling CSS, reusable design tokens
Data service Firebase / Firestore
Code quality oxlint
Analytics Vercel Web Analytics
Hosting and deployment Vercel

Run locally

Requirements: a recent version of Node.js and npm.

git clone https://github.com/sunmeat/me.git
cd me
npm install
npm run dev

Production build and preview:

npm run build
npm run preview

Run the code-quality checks:

npm run lint

Some interactive features require Firebase configuration. See env.example and the deployment guide before configuring a local environment. Never commit real credentials or private environment files.

Project structure

me/
├── .github/       # Community files, templates, and automation
├── docs/          # Project and maintenance documentation
├── public/        # Static assets and preview images
├── src/
│   ├── components/  # Page sections and reusable UI
│   ├── App.jsx      # Main page composition
│   ├── data.js      # Portfolio content and profile data
│   ├── firebase.js  # Firebase setup
│   ├── App.css      # Styles and design tokens
│   └── main.jsx     # Application entry point
├── index.html     # HTML shell and metadata
├── package.json   # Scripts and dependencies
└── vite.config.js # Vite configuration

Most portfolio copy, project lists, skills, and profile statistics are maintained in src/data.js. Reusable page sections live in src/components/.

Documentation library

Start with the documentation index, or jump straight to a topic.

Guide What it covers
Documentation index Guide map and documentation overview
Architecture Application structure, components, and data flow
Content guide Updating profile details, projects, skills, and statistics
Design system Colors, typography, spacing, and visual conventions
Development & deployment Local setup, build, environment, and Vercel deployment
Quality checklist Checks to run before publishing changes
SEO & metadata Search metadata, social previews, and structured data
Troubleshooting Common issues and practical fixes

Repository policies and reference files

All repository-level documents are linked below so they are easy to find and maintain.

Document Purpose
Accessibility Accessibility principles and checks
Changelog Notable project changes
Citation metadata How to cite this project
Code of conduct Community expectations
Contributing Contribution and change workflow
Code owners Ownership rules for repository paths
Governance Project stewardship and decision-making
License notice Short repository license notice
Full license terms Copyright and permitted use
Security policy Reporting security concerns
Support Where to ask questions or request help
Community & automation Repository templates and GitHub automation guidance
Markdown lint configuration Markdown style rules
Oxlint configuration JavaScript lint rules
Environment example Example configuration keys, without secrets

Find me

License

© Oleksandr Zahoruiko. All rights reserved. The source is publicly viewable for reference and learning; public visibility does not grant permission to copy, redistribute, or present the design, content, or implementation as your own. Read the full license.

Russian flag Русский

О проекте

sunmeat.dev это моё персональное портфолио и живая витрина проектов. Здесь собраны работы в full-stack-разработке, нативном Android, преподавании IT и независимых экспериментах.

Визуальный стиль сочетает тёмную эстетику терминала с аккуратной адаптивной вёрсткой. Репозиторий сопровождается документацией, которая объясняет устройство проекта, дизайн-систему, обновление контента, проверки и публикацию.

В цифрах

14 5+ 19+ 247
Сайтов и проектов Android-приложений Лет в разработке и преподавании Репозиториев GitHub

Цифры соответствуют текущим данным портфолио и могут меняться.

Что внутри

  • Профессиональный профиль: опыт, навыки, образование и контакты.
  • Android-приложения: опубликованные приложения со ссылками на Google Play.
  • Веб-проекты: работающие сайты и независимые эксперименты.
  • Технологический стек: языки, фреймворки, платформы и инструменты.
  • Интерактивная карточка профиля: комментарии на Firebase / Firestore.
  • Адаптивный интерфейс: поддержка телефонов, планшетов и компьютеров.
  • SEO и аналитика: метаданные, Open Graph, структурированные данные и Vercel Web Analytics.

Технологии

Область Инструменты
Интерфейс React 19, JavaScript, Vite
Стили CSS, система дизайн-токенов
Данные Firebase / Firestore
Проверка кода oxlint
Аналитика Vercel Web Analytics
Публикация Vercel

Запуск локально

Требования: актуальная версия Node.js и npm.

git clone https://github.com/sunmeat/me.git
cd me
npm install
npm run dev

Сборка и локальный просмотр production-версии:

npm run build
npm run preview

Проверка качества кода:

npm run lint

Некоторые интерактивные функции требуют конфигурации Firebase. Перед настройкой локального окружения изучите env.example и руководство по публикации. Не добавляйте реальные ключи и секреты в репозиторий.

Структура проекта

me/
├── .github/       # Документы сообщества, шаблоны и автоматизация
├── docs/          # Документация проекта
├── public/        # Статические ресурсы и изображения
├── src/
│   ├── components/  # Секции страницы и компоненты интерфейса
│   ├── App.jsx      # Компоновка главной страницы
│   ├── data.js      # Контент, проекты и данные профиля
│   ├── firebase.js  # Настройка Firebase
│   ├── App.css      # Стили и дизайн-токены
│   └── main.jsx     # Точка входа приложения
├── index.html     # HTML и метаданные
├── package.json   # Скрипты и зависимости
└── vite.config.js # Конфигурация Vite

Основной контент портфолио, проекты, навыки и статистика находятся в src/data.js. Повторно используемые секции интерфейса находятся в src/components/.

Библиотека документации

Начните с оглавления документации или откройте нужное руководство напрямую.

Документ Содержание
Оглавление документации Навигация по руководствам
Архитектура Структура приложения, компоненты и потоки данных
Руководство по контенту Обновление профиля, проектов, навыков и статистики
Дизайн-система Цвета, типографика, отступы и визуальные правила
Разработка и публикация Локальный запуск, сборка, окружение и Vercel
Чек-лист качества Проверки перед публикацией изменений
SEO и метаданные Поисковые данные, превью соцсетей и структурированные данные
Решение проблем Типичные ошибки и способы исправления

Политики и справочные файлы репозитория

Все документы репозитория собраны в одном месте, чтобы нужные правила и инструкции не приходилось искать вручную.

Документ Назначение
Доступность Принципы доступности и проверки интерфейса
История изменений Значимые изменения проекта
Данные для цитирования Как сослаться на проект
Кодекс поведения Правила общения в сообществе
Участие в разработке Как предлагать и оформлять изменения
Ответственные за код Владельцы отдельных путей репозитория
Управление проектом Поддержка проекта и принятие решений
Краткое уведомление о лицензии Краткие условия использования
Полный текст лицензии Авторские права и разрешённое использование
Политика безопасности Как сообщить об уязвимости
Поддержка Куда обращаться с вопросами
Сообщество и автоматизация Шаблоны GitHub и автоматизация репозитория
Настройки Markdownlint Правила оформления Markdown
Настройки Oxlint Правила проверки JavaScript
Пример переменных окружения Пример настроек без секретов

Контакты

Лицензия

© Oleksandr Zahoruiko. Все права защищены. Исходный код открыт для ознакомления и обучения, но публичный доступ не означает разрешения копировать, распространять или выдавать дизайн, контент и реализацию за собственную работу. Подробности в полном тексте лицензии.

French flag Français

Présentation

sunmeat.dev est mon portfolio personnel et une vitrine vivante de mes projets. Il rassemble mon travail en développement full-stack, applications Android natives, enseignement informatique et expérimentations indépendantes.

Son identité visuelle associe une esthétique sombre inspirée du terminal à une interface responsive soignée. Le dépôt comprend également une documentation structurée sur l'architecture, le système de design, la mise à jour du contenu, les contrôles qualité et le déploiement.

En quelques chiffres

14 5+ 19+ 247
Sites et projets Applications Android Années en développement et enseignement Dépôts GitHub

Ces chiffres correspondent aux informations actuellement présentées sur le portfolio et peuvent évoluer.

Ce que vous trouverez

  • Un profil professionnel : parcours, expérience, compétences et coordonnées.
  • Des applications Android : applications publiées avec leurs liens Google Play.
  • Des projets web : sites en ligne et expérimentations indépendantes.
  • Une vue technique : langages, frameworks, plateformes et outils.
  • Une carte de profil interactive : commentaires via Firebase / Firestore.
  • Une interface responsive : adaptée aux mobiles, tablettes et ordinateurs.
  • SEO et statistiques : métadonnées, aperçus Open Graph, données structurées et Vercel Web Analytics.

Technologies

Domaine Outils
Interface React 19, JavaScript, Vite
Styles CSS, système de variables de design
Données Firebase / Firestore
Qualité du code oxlint
Analytique Vercel Web Analytics
Hébergement et déploiement Vercel

Lancer le projet en local

Prérequis : une version récente de Node.js et npm.

git clone https://github.com/sunmeat/me.git
cd me
npm install
npm run dev

Construire et prévisualiser la version de production :

npm run build
npm run preview

Lancer les contrôles de qualité :

npm run lint

Certaines fonctions interactives nécessitent une configuration Firebase. Consultez env.example et le guide de déploiement avant de configurer l'environnement local. Ne publiez jamais de clés réelles ni de secrets dans le dépôt.

Structure du projet

me/
├── .github/       # Fichiers communautaires, modèles et automatisation
├── docs/          # Documentation du projet
├── public/        # Ressources statiques et images
├── src/
│   ├── components/  # Sections de page et composants réutilisables
│   ├── App.jsx      # Composition de la page principale
│   ├── data.js      # Contenu, projets et données du profil
│   ├── firebase.js  # Configuration Firebase
│   ├── App.css      # Styles et variables de design
│   └── main.jsx     # Point d'entrée de l'application
├── index.html     # Structure HTML et métadonnées
├── package.json   # Scripts et dépendances
└── vite.config.js # Configuration Vite

Le contenu du portfolio, les projets, les compétences et les statistiques sont principalement gérés dans src/data.js. Les sections réutilisables se trouvent dans src/components/.

Bibliothèque de documentation

Commencez par le sommaire de la documentation, ou ouvrez directement le guide souhaité.

Guide Contenu
Sommaire de la documentation Vue d'ensemble et navigation
Architecture Structure de l'application, composants et flux de données
Guide de contenu Mise à jour du profil, des projets, compétences et statistiques
Système de design Couleurs, typographie, espacements et conventions visuelles
Développement et déploiement Installation locale, compilation, environnement et Vercel
Liste de contrôle qualité Vérifications avant publication
SEO et métadonnées Référencement, aperçus sociaux et données structurées
Dépannage Problèmes fréquents et solutions

Politiques et fichiers de référence

Tous les documents du dépôt sont répertoriés ici pour faciliter leur consultation et leur maintenance.

Document Utilité
Accessibilité Principes et contrôles d'accessibilité
Journal des modifications Changements notables du projet
Métadonnées de citation Comment citer ce projet
Code de conduite Attentes au sein de la communauté
Contribution Procédure de contribution et de modification
Responsables du code Responsables des chemins du dépôt
Gouvernance Gestion du projet et prise de décision
Notice de licence Résumé des conditions de licence
Texte complet de la licence Droits d'auteur et utilisations autorisées
Politique de sécurité Signaler un problème de sécurité
Assistance Où poser des questions et demander de l'aide
Communauté et automatisation Modèles GitHub et automatisation du dépôt
Configuration Markdownlint Règles de style Markdown
Configuration Oxlint Règles de vérification JavaScript
Exemple de variables d'environnement Exemple de configuration sans secrets

Me contacter

Licence

© Oleksandr Zahoruiko. Tous droits réservés. Le code source est consultable à des fins de référence et d'apprentissage. Son accès public n'autorise pas la copie, la redistribution ni la présentation du design, du contenu ou de l'implémentation comme étant votre propre travail. Consultez la licence complète.

Built with care in Odesa, Ukraine.

Portfolio · GitHub · Documentation