Note-Z is a next-generation, location-based note-taking app crafted exclusively for Gen-Z. It delivers a playful, cartoon-style map interface that emphasizes focused, short-term task management with a sleek, modern design.
- Weekly Reset System: All notes automatically reset every Sunday, encouraging a fresh start each week and reducing digital clutter
- Location-Based Notes: Drop pins anywhere on the map to create geo-tagged notes and reminders
- Modern UI/UX Design: Apple-inspired design philosophy with frosted glass effects, clean typography, and proper spacing
- Interactive Map Experience: Smooth animations when navigating the map, with color-coded markers for different urgency levels
- Note Management:
- Create notes with title, description, and optional deadline
- View all notes in a convenient bottom sheet list
- Filter notes by day of the week
- Edit or delete existing notes
- Auto-categorization of notes by urgency based on deadline proximity
- Visual Prioritization: Color coding of notes based on deadline urgency (low, medium, high, past due)
- Local Data Privacy: All data stored locally on your device - no accounts, no cloud storage, no tracking
| Map with Notes | Navigating to a Note |
|---|---|
|
 |
| Create Note | Edit Note | Note Details |
|---|---|---|
 |
 |
 |
| All Notes | Filter by Monday | Filter by Wednesday | Filter by Friday | Filter by Saturday |
|---|---|---|---|---|
 |
 |
 |
 |
 |
| Empty Notes List | Empty Note View |
|---|---|
 |
 |
- Flutter SDK (version ^3.7.2)
- Dart (latest stable)
- Mapbox account and access token
- Android Studio/VS Code with Flutter extension
- iOS: XCode (for MacOS users)
- Android: Android Studio with emulator setup
-
Clone the repository
git clone https://github.com/ifarangiis/Note-Z.git cd Note-Z -
Set up environment variables Create a
.envfile in the project root directory:MAPBOX_TOKEN=your_mapbox_token_here -
Install dependencies
flutter pub get
-
Run the app in development mode
flutter run
-
Build for production
- Android:
flutter build apk --release
- iOS:
flutter build ios --release
- Android:
- Mapbox Token Issues: Ensure your token has the proper permissions for the Maps SDK.
- Build Errors: Make sure you've set up the platform-specific configurations:
- Android: Check AndroidManifest.xml for permissions
- iOS: Verify Info.plist contains the necessary permission declarations
Note-Z follows a simple but effective architecture:
- Models: Data structures for notes and other objects
- Screens: UI components for different screens
- Services: Business logic and external API integrations
- Utils: Helper utilities for colors, dates, etc.
- Widgets: Reusable UI components
The app uses a carefully designed color system that powers its visual identity:
// Primary colors
static const Color primary = Color(0xFFFF4EC0); // Pink
static const Color secondary = Color(0xFF6A35FC); // PurpleThe color utility provides:
- App theme colors (primary, secondary, tertiary)
- Gradient combinations for various UI elements
- A semantic color system for note urgency levels (low, medium, high, past due)
- Helper methods to generate urgency colors based on deadline proximity
This centralized approach ensures consistent branding throughout the app and makes theming changes straightforward.
The MapboxService handles all interactions with the Mapbox Maps SDK:
// Get a cartoon-style map style URI
static String get cartoonStyleUri {
return 'mapbox://styles/mapbox/streets-v12';
}Key features:
- Token Management: Securely manages the Mapbox access token from environment variables
- Map Styling: Configures the map with a cartoon-style appearance
- Camera Control: Provides methods for dynamic camera positioning with smooth animations
- Marker Creation: Utilities for creating styled markers for notes
To integrate Mapbox in your own Flutter app:
- Create a Mapbox account and get an access token
- Add the
mapbox_maps_flutterpackage to your pubspec.yaml - Create a service similar to
MapboxServiceto abstract SDK interactions - Initialize the map using
MapWidgetfrom the SDK - Set up map event listeners for user interactions
Note-Z features a smart date system that:
- Calculates days remaining until the weekly reset
- Formats dates in user-friendly ways
- Determines note urgency based on deadline proximity
- Provides custom date picker UI for deadline selection
The app implements a local-first storage approach:
- Notes are saved to device storage using SharedPreferences
- No data is sent to external servers
- Weekly reset functionality automatically clears notes every Sunday
- Weekly Analytics: Visual statistics of completed vs. pending notes
- Custom Map Styles: Additional map themes beyond the cartoon style
- Search & Filtering: Advanced note search and filtering options
- Categories & Tags: Organize notes with custom categories
- Dark Mode: Full dark mode support
- Weather Integration: Display weather information on the map
- Multiple Maps: Support for different map providers
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
- Follow Flutter best practices
- Maintain the existing code style
- Add tests for new functionality
- Update documentation for changes
⭐ If you find Note-Z interesting, consider starring this repo to help spread the word.
This project is licensed under the MIT License - see the LICENSE file for details.
Note-Z embraces the Gen-Z philosophy: focus on what matters right now, reject digital clutter, and start fresh often. The weekly reset feature isn't just a technical function—it's a lifestyle choice that promotes digital minimalism.
