Skip to content

Rijak2005/Plasmable-Source-Code

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

20 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🧬 Plasmable - Plasma Donor Connection App

A modern Flutter application designed to connect people in need with verified plasma donors. Plasmable streamlines the process of finding compatible plasma donors through an intuitive, user-friendly mobile interface.


🎯 Mission

Helping people connect with verified plasma donors in their time of need. Plasmable eliminates barriers in plasma donation by creating a seamless bridge between donors and recipients through technology.


✨ Features

πŸ‘₯ Core Functionality

  • Donor Discovery - Browse and connect with verified plasma donors in your area
  • User Verification - Secure verification system to ensure donor reliability
  • Intuitive Navigation - Smooth, modern UI with optimized navigation experience
  • Real-time Connectivity - Stay connected with verified plasma donors

🎨 User Experience

  • Modern Design - Clean, intuitive interface built with Material Design
  • Responsive Layout - Adaptive UI that works seamlessly across different device sizes
  • Custom Navigation - Google Navigation Bar and Flutter Snake Navigation Bar for smooth transitions
  • Beautiful Typography - Google Fonts integration with Poppins as the default font family

πŸ”’ Data Management

  • Local Storage - Shared Preferences for persistent user data
  • HTTP Integration - Seamless API communication for real-time data sync
  • Toast Notifications - Non-intrusive user feedback system

πŸ› οΈ Technology Stack

Framework & Language

  • Flutter - Modern, cross-platform mobile development framework
  • Dart (96. 3%) - Primary programming language with strong typing and performance
  • Ruby (3.2%) - Supporting tooling and scripts

Key Dependencies

  • flutter_svg - SVG rendering for scalable graphics
  • google_fonts - Access to Google's extensive font library
  • google_nav_bar - Advanced navigation bar component
  • flutter_snake_navigationbar - Animated snake navigation
  • url_launcher - External URL and app launching
  • http - HTTP client for API requests
  • shared_preferences - Persistent local storage
  • fluttertoast - Toast notification system
  • line_icons - Icon library for UI elements
  • cupertino_icons - iOS-style icon pack

Design System

  • Material Design - Google's design system implementation
  • Custom Theme - Primary color-based consistent styling
  • SVG Assets - Vector-based graphics for crisp visuals
  • Responsive Typography - Adaptive font sizes and scales

πŸ“± Platform Support

  • Android - Full support with native integration
  • iOS - Full support with Cupertino Design
  • Cross-platform - Single codebase for both platforms

πŸ“‚ Project Structure

Plasmable-Source-Code/
β”œβ”€β”€ lib/                          # Main application code
β”‚   β”œβ”€β”€ main.dart                 # App entry point with theme configuration
β”‚   β”œβ”€β”€ home_page.dart            # Primary home screen
β”‚   β”œβ”€β”€ constants.dart            # App-wide constants and colors
β”‚   β”œβ”€β”€ constant2.dart            # Additional configuration constants
β”‚   β”œβ”€β”€ data. dart                 # Local data models and fixtures
β”‚   β”œβ”€β”€ size_config.dart          # Responsive sizing utilities
β”‚   β”œβ”€β”€ size_config_profile.dart  # Profile-specific size configuration
β”‚   β”œβ”€β”€ sizeConfigSplash.dart     # Splash screen sizing
β”‚   β”œβ”€β”€ screens/                  # Screen implementations
β”‚   β”‚   β”œβ”€β”€ logoScreen.dart       # Splash/Logo screen
β”‚   β”‚   └── [other screens]       # Feature screens
β”‚   β”œβ”€β”€ components/               # Reusable UI components
β”‚   β”œβ”€β”€ models/                   # Data models and schemas
β”‚   └── [other utilities]
β”œβ”€β”€ android/                      # Android native configuration
β”œβ”€β”€ ios/                          # iOS native configuration
β”œβ”€β”€ assets/
β”‚   β”œβ”€β”€ images/                   # App images and graphics
β”‚   └── icons/                    # Custom icon assets
β”œβ”€β”€ pubspec.yaml                  # Project dependencies and configuration
└── README.md                     # Project documentation

πŸš€ Getting Started

Prerequisites

  • Flutter SDK (>=2.7.0 <3.0.0)
  • Dart SDK (included with Flutter)
  • Android Studio or Xcode (for native development)
  • Git for version control

Installation

  1. Clone the repository

    git clone https://github.com/Rijak2005/Plasmable-Source-Code.git
    cd Plasmable-Source-Code
  2. Install dependencies

    flutter pub get
  3. Generate launcher icons

    flutter pub run flutter_launcher_icons:main
  4. Run the application

    flutter run

Building for Release

Android:

flutter build apk --release
# or
flutter build appbundle --release

iOS:

flutter build ios --release

🎨 Design Highlights

  • Poppins Font - Modern, friendly typography throughout the app
  • Material Design - Consistent, intuitive UI patterns
  • Adaptive Layout - Size config utilities ensure responsive design across devices
  • SVG Graphics - Crisp, scalable vector graphics
  • Color-Coded UI - Primary color-based visual hierarchy

πŸ“Έ Screenshots

The app features a polished interface showcasing:

  • Plasma donor discovery interface
  • User profile management
  • Donation coordination system
  • Verification workflow
Screenshot 1 Screenshot 2 Screenshot 3 Screenshot 4

πŸ”§ Configuration

Environment

  • SDK Version: >=2.7.0 <3.0.0
  • Material Design: Enabled with Material Icons
  • Platform Density: Adaptive (responds to platform norms)

App Configuration

  • App Name: Plasmable
  • Primary Color: Defined in constants.dart
  • Default Font: Poppins (Google Fonts)
  • Navigation: Multi-bar system for intuitive navigation

πŸ“¦ Dependencies Management

All dependencies are managed through pubspec.yaml and pubspec. lock. To update dependencies:

flutter pub upgrade

For specific package information, visit pub.dev.


🌟 Key Features Breakdown

Responsive Design

  • Size Config Utilities - Adaptive scaling based on device dimensions
  • Profile-Specific Configuration - Tailored UI for different user roles
  • Splash Screen Optimization - Custom sizing for launch experience

Navigation Experience

  • Google Navigation Bar - Modern floating navigation with smooth transitions
  • Snake Navigation Bar - Animated, engaging navigation elements
  • Smooth Screen Transitions - Professional page navigation

Data Handling

  • HTTP Integration - RESTful API communication
  • Local Persistence - Shared Preferences for offline functionality
  • Real-time Updates - Dynamic data synchronization

🀝 Contributing

Contributions are welcome! To contribute:

  1. Fork the repository
  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 open source and available for community use and development.


πŸ’‘ Development Notes

  • The app uses a responsive design system with multiple size configuration files
  • HTTP requests are handled for real-time data synchronization
  • Local data is persisted using shared preferences
  • UI components are modular and reusable
  • Assets include both images and custom icons for consistent branding

πŸ“ž Support

For issues, feature requests, or questions, please open an issue on the GitHub repository.


πŸŽ“ Learning Resources


Built with ❀️ by @Rijak2005

Connecting People. Saving Lives. 🧬

About

A modern Flutter application designed to connect people in need with verified plasma donors.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages