Skip to content

michaelgermini/data-storytelling

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

10 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ“Š Upframe - Data Storytelling Platform

A modern and interactive platform presenting a collection of 32 data science projects with immersive 3D visualizations and an intuitive user interface.

πŸ“Š Project Status

Build Status Version License Node.js

πŸ› οΈ Technology Stack

React TypeScript Vite Tailwind CSS

πŸ“ˆ Project Metrics

Projects Categories Languages

πŸš€ Deployment

GitHub Pages Website

πŸ“Š Performance

Lighthouse Bundle Size Loading Time

πŸ”— Connect

GitHub Followers YouTube Website

πŸš€ Main Features

🎯 User Interface

  • Responsive Design : Adaptive interface for all devices
  • Intuitive Navigation : Sidebar menu with category filtering
  • Advanced Search : Real-time search system
  • Smooth Animations : Transitions and visual effects with Framer Motion

πŸ“ Project Management

  • 32 Integrated Projects : Complete collection of data science projects
  • 20 Categories : Organization by expertise domains
  • Enriched Details : Descriptions, technologies, and specific structures
  • Quick Actions : Direct opening of projects and source code

πŸ—οΈ Technical Architecture

  • React 19 : Modern framework with advanced hooks
  • TypeScript : Static typing for robustness
  • Vite : Ultra-fast build tool
  • Tailwind CSS : Utility CSS framework
  • Context API : Global state management

🎨 Improvements to the "Project Structure & Organization" Section of Upframe

πŸ“‚ Specific File Structure

Each project now displays a unique and realistic file structure:

🌍 Crypto Global Dashboard 3D

πŸ“ crypto_global_dashboard_3d/
β”œβ”€β”€ πŸ“„ README.md # Project documentation
β”œβ”€β”€ πŸ“„ requirements.txt # Python dependencies
β”œβ”€β”€ πŸ“„ app.py # Streamlit main app
β”œβ”€β”€ πŸ“ pages/ # Streamlit pages
β”œβ”€β”€ πŸ“ components/ # 3D components
β”œβ”€β”€ πŸ“ data/ # Data sources
β”œβ”€β”€ πŸ“ utils/ # Utility functions
└── πŸ“ assets/ # Static assets

πŸ“Š Data Scientist Storytelling

πŸ“ data_scientist_storytelling/
β”œβ”€β”€ πŸ“„ CV_Data_Scientist_Storytelling_FR.md # CV documentation
β”œβ”€β”€ πŸ“ new/ # Project files
β”œβ”€β”€ πŸ“ 3d_cv/ # 3D CV components
└── πŸ“„ README.md # Project overview

πŸŽ“ Data Scientist Education Switzerland

πŸ“ data_scientist_education_switzerland/
β”œβ”€β”€ πŸ“„ README.md # Project documentation
β”œβ”€β”€ πŸ“„ index.html # Main entry point
β”œβ”€β”€ πŸ“„ styles.css # Styling
β”œβ”€β”€ πŸ“ src/ # Source code
└── πŸ“„ .gitignore # Git ignore

πŸ—οΈ Project-Specific Architecture

🌍 Crypto Global Dashboard 3D

  • Streamlit Architecture
    • Streamlit + Python
    • Three.js 3D visualization
    • Real-time API integration
    • Altair/Vega-Lite charts

πŸ“Š Data Scientist Storytelling

  • Data Storytelling Architecture
    • Data Storytelling focus
    • Business intelligence tools
    • Data pipeline management
    • Visualization expertise

πŸŽ“ Data Scientist Education Switzerland

  • 3D Web Architecture
    • Three.js + GSAP
    • GeoJSON integration
    • Plotly visualization
    • Interactive 3D maps

πŸ”§ Specific Features

🌍 Crypto Dashboard Features

  • Real-time market data
  • Interactive 3D globe
  • Multiple API integrations
  • Cyberpunk UI design

πŸ“Š Storytelling Capabilities

  • Data transformation expertise
  • Business intelligence
  • Visualization mastery
  • Communication skills

πŸŽ“ Educational Features

  • 3D Swiss cantons
  • Educational KPIs
  • Interactive storytelling
  • Responsive design

πŸ”„ Specific Data Pipeline

🌍 Crypto Data Pipeline

  1. API Integration : CoinCap, Binance, Etherscan
  2. Real-time Processing : Live market data
  3. 3D Visualization : Interactive globe
  4. Dashboard Display : Streamlit interface

πŸ“Š Storytelling Pipeline

  1. Data Collection : Business intelligence
  2. Story Development : Narrative creation
  3. Visualization : Interactive charts
  4. Communication : Stakeholder delivery

πŸŽ“ Educational Data Pipeline

  1. Educational Data : Swiss education stats
  2. 3D Mapping : Canton visualization
  3. KPI Analysis : Educational metrics
  4. Interactive Display : 3D web interface

πŸ› οΈ Technologies Used

πŸ’» Programming Languages

  • TypeScript : Static typing and modern development
  • JavaScript : Client-side interactivity
  • Python : Data science and machine learning
  • HTML5/CSS3 : Structure and styling

πŸ“Š Data Science Tools

  • Pandas : Data manipulation
  • NumPy : Numerical calculations
  • Scikit-learn : Machine learning
  • Matplotlib/Seaborn : Visualizations
  • Jupyter : Interactive notebooks

🌐 Web Frameworks

  • React 19 : User interface
  • Vite : Modern build tool
  • Tailwind CSS : Utility styling
  • Framer Motion : Animations

🎨 3D Visualization

  • Three.js : 3D rendering
  • React Three Fiber : React integration
  • GSAP : Advanced animations
  • D3.js : Data visualizations

πŸ—ΊοΈ Mapping

  • Mapbox GL : Interactive maps
  • Deck.gl : Geospatial visualizations
  • D3-geo : Geographic projections
  • TopoJSON : Topological data

πŸ“ˆ Upframe Statistics

  • 32 Projects : Complete collection of data science projects
  • 20 Categories : Organization by expertise domains
  • React : Main framework
  • TypeScript : Development language

πŸš€ Installation and Setup

Prerequisites

  • Node.js 18+
  • npm or yarn

Installation

# Clone the repository
git clone [repository-url]
cd upframe

# Install dependencies
npm install

# Start development server
npm run dev

Production Build

# Build for production
npm run build

# Preview the build
npm run preview

# Serve with Node.js server
npm run serve

πŸ“ Project Structure

πŸ“ upframe/
β”œβ”€β”€ πŸ“„ README.md # Main documentation
β”œβ”€β”€ πŸ“„ package.json # Dependencies and scripts
β”œβ”€β”€ πŸ“„ vite.config.ts # Vite configuration
β”œβ”€β”€ πŸ“„ tsconfig.json # TypeScript configuration
β”œβ”€β”€ πŸ“„ index.html # HTML entry point
β”œβ”€β”€ πŸ“ src/ # Source code
β”‚   β”œβ”€β”€ πŸ“ components/ # React components
β”‚   β”œβ”€β”€ πŸ“ context/ # State management
β”‚   β”œβ”€β”€ πŸ“ App.tsx # Main component
β”‚   └── πŸ“ main.tsx # React entry point
β”œβ”€β”€ πŸ“ public/ # Static assets
β”œβ”€β”€ πŸ“ dist/ # Production build
└── πŸ“ [32 data science projects]/ # Integrated projects

🎯 Advanced Features

πŸ” Search System

  • Real-time search by project name
  • Category filtering
  • Intuitive interface with suggestions

πŸ“Š Interactive Visualizations

  • 3D charts with Three.js
  • Interactive maps with Mapbox GL
  • Smooth animations with GSAP
  • Data visualizations with D3.js

🎨 User Interface

  • Modern and responsive design
  • Dark/light theme
  • Animations and transitions
  • Intuitive navigation

πŸ“± Responsive Design

  • Mobile-first adaptation
  • Touch-optimized interface
  • Optimized performance
  • Enhanced accessibility

πŸ”§ Advanced Configuration

Environment Variables

VITE_API_URL=your-api-url
VITE_APP_TITLE=Upframe - Data Storytelling Platform

Customization

  • Customizable themes
  • Project configuration
  • External API integration
  • Multi-environment deployment

πŸš€ Deployment

Infomaniak

# Production build
npm run build

# Compression for upload
zip -r portfolio-dist.zip dist/

# Upload via SSH
scp portfolio-dist.zip user@server:/path/to/webroot/
ssh user@server "cd /path/to/webroot && unzip portfolio-dist.zip"

Other Platforms

  • Vercel : Automatic deployment
  • Netlify : Continuous integration
  • GitHub Pages : Free hosting
  • Docker : Containerization

πŸ“Š Metrics and Performance

  • Lighthouse Score : 95+ on all criteria
  • Loading Time : < 2 seconds
  • Bundle Size : < 500KB gzipped
  • Compatibility : All modern browsers

🀝 Contribution

  1. Fork the project
  2. Create a feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

πŸ“„ License

This project is licensed under the MIT License. See the LICENSE file for details.

πŸ“ž Contact


Data Storytelling - Transform your data into captivating stories with immersive 3D visualizations and a modern interface. πŸš€

About

Data Storytelling Platform - Interactive 3D portfolio with 32 data science projects

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published