A clean and responsive Flutter notes application that works seamlessly across all platforms and screen sizes.
Developed by: Osama Elkayyal
- Login Screen Screenshot
- Home Screen with Notes
- Add/Edit Note Screen
- Folders Management Screen
- Responsive Design Examples
🤖 Android APK: OS-Notes-v1.0.1.apk
- Version: 1.0.1
- Size: ~22 MB
- Requirements: Android 5.0+ (API 21)
📁 More releases and installation instructions available in the releases folder.
- Responsive Design: Adapts beautifully to different screen sizes (mobile, tablet, desktop)
- Cross-Platform: Runs on Android, iOS, Web, Windows, macOS, and Linux
- Clean Architecture: Well-organized code structure with separation of concerns
- Material Design 3: Modern UI following Google's latest design guidelines
- Local Database: SQLite database for offline storage
- State Management: Provider pattern for efficient state management
- Folder Organization: Organize notes into colorful folders
- User Authentication: Secure login system with email and password
- Note Management: Create, edit, delete, and search notes with color customization
- UI Settings: Customizable user interface preferences
lib/
├── main.dart # App entry point
├── core/ # Core utilities and themes
│ ├── app_theme.dart # App theming configuration
│ ├── colors.dart # Color definitions
│ └── widgets/ # Shared widgets
│ └── app_note_card.dart # Note card component
├── models/ # Data models
│ ├── note_model.dart # Note data model
│ └── folder_model.dart # Folder data model
├── database/ # Database layer
│ └── database_helper.dart # SQLite database helper
├── providers/ # State management
│ ├── note_provider.dart # Notes state management
│ ├── folder_provider.dart # Folders state management
│ ├── theme_provider.dart # Theme state management
│ └── ui_settings_provider.dart # UI settings state management
└── screens/ # UI screens
├── splash_screen.dart # Splash/loading screen
├── login_screen.dart # User authentication screen
├── home_screen.dart # Main notes display screen
├── add_note_screen.dart # Add/edit note screen
└── folders_screen.dart # Folder management screen
- Flutter SDK (>=3.8.1)
- Dart SDK
- Android Studio or VS Code with Flutter extensions
- Clone the repository:
git clone https://github.com/Osama7amed04/OS-Notes.git
cd OS-Notes- Install dependencies:
flutter pub get- Run the app:
# For development
flutter run
# For specific platforms
flutter run -d chrome # Web
flutter run -d windows # Windows
flutter run -d android # Android
flutter run -d ios # iOS (macOS required)# Android APK
flutter build apk --release
# Android App Bundle (recommended for Play Store)
flutter build appbundle --release
# Web
flutter build web --release
# Windows
flutter build windows --release
# iOS (macOS required)
flutter build ios --release- Create and edit rich text notes
- Delete notes with confirmation
- Color-coded notes for better organization
- Search functionality across all notes
- Sort notes by creation date
- Create custom folders with unique colors
- Organize notes into specific folders
- Edit and delete folders
- Unfiled notes category for loose notes
- Secure login with email/password
- Persistent login state
- Customizable UI settings
- Responsive design for all screen sizes
- Smooth animations and transitions
The app automatically adapts its layout based on screen size:
- Mobile (< 600px): Single column layout with optimized touch targets
- Tablet (600px - 1200px): Grid layout for better space utilization
- Desktop (> 1200px): Multi-column layout with enhanced navigation
dependencies:
flutter: sdk
provider: ^6.0.5 # State management pattern
sqflite: ^2.3.3 # Local SQLite database
shared_preferences: ^2.5.3 # Local preferences storage
path: ^1.9.0 # Path manipulation utilities
cupertino_icons: ^1.0.8 # iOS-style icons
dev_dependencies:
flutter_test: sdk
flutter_lints: ^4.0.0 # Dart code linting rules- First Launch: Enter your email and password to create an account
- Create Notes: Tap the + button to add a new note
- Organize with Folders: Use the folders screen to organize your notes
- Customize Colors: Choose different colors for notes and folders
- Search: Use the search bar to quickly find your notes
- Edit: Tap any note to edit its content
The app follows a clean architecture pattern:
- Models: Data structures for notes and folders
- Providers: State management using the Provider pattern
- Database: SQLite for local data persistence
- Screens: UI components organized by functionality
- Core: Shared utilities, themes, and widgets
We welcome contributions! Please see our Contributing Guidelines for details.
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
See CHANGELOG.md for a detailed list of changes and updates.
- ✅ Complete notes app with folder organization
- ✅ Clean project structure with organized folders
- ✅ Responsive design for all screen sizes
- ✅ User authentication system
- ✅ SQLite database for local storage
- ✅ Material Design 3 UI
- ✅ Color-coded folders and notes
- ✅ Search functionality
- ✅ Customizable UI settings
Osama Elkayyal
- 🚀 Passionate Flutter Developer
- 🎯 Focus on clean code and exceptional user experience
- 💻 Expertise in cross-platform mobile development
- 📱 Specializing in responsive and modern UI/UX design
- GitHub: @Osama7amed04
- Repository: OS-Notes
This project is licensed under the MIT License - see the LICENSE file for details.
Please see our Security Policy for reporting vulnerabilities and security best practices.
If you have any questions or need help:
- 📋 Open an issue on GitHub
- 📧 Contact the developer: Osama Elkayyal
- 📚 Check the documentation and contributing guidelines
Made with ❤️ using Flutter by Osama Elkayyal