Skip to content

abdallah96/devtrackr

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

67 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸš€ G-Tracker β€” Modern Productivity & Journal App

A beautiful, full-stack productivity application for tracking tasks, journal entries, and visualizing your productivity journey. Built with a modern tech stack and designed for both web and desktop use.

G-Tracker Dashboard React Node.js Database


✨ Features

🎯 Core Functionality

  • πŸ“ Task Management: Add, edit, delete, and mark tasks as complete
  • πŸ“– Journal Entries: Write, edit, and search through journal entries
  • πŸ“Š Productivity Dashboard: Visual progress tracking and weekly insights
  • πŸ” Search & Filter: Find specific tasks and journal entries quickly

🎨 User Experience

  • πŸŒ™ Dark Theme: Beautiful, modern dark interface
  • πŸ“± Responsive Design: Works perfectly on desktop, tablet, and mobile
  • ⚑ Real-time Updates: Instant UI updates with optimistic rendering
  • 🎯 Inline Actions: Edit and delete with smooth inline confirmations

πŸ—οΈ Technical Features

  • πŸ’Ύ Persistent Storage: PostgreSQL database with Prisma ORM
  • πŸ”„ Real-time Sync: Frontend-backend communication via REST API
  • πŸ–₯️ Desktop App: Install as PWA or build with Electron
  • πŸš€ Production Ready: Deploy to Vercel with serverless functions

πŸ› οΈ Tech Stack

Frontend

  • React 19 - Modern UI framework
  • CSS3 - Custom styling with dark theme
  • PWA - Progressive Web App capabilities

Backend

  • Node.js - Runtime environment
  • Express.js - Web framework
  • Prisma - Database ORM
  • PostgreSQL - Production database

Development & Deployment

  • Vercel - Serverless deployment
  • Electron - Desktop app packaging
  • GitHub - Version control

πŸš€ Quick Start

Prerequisites

  • Node.js 18+
  • PostgreSQL database
  • npm or yarn

Installation

# Clone the repository
git clone https://github.com/your-username/gtracker.git
cd gtracker/devtrackr

# Install dependencies
yarn install

# Set up environment variables
cp .env.example .env
# Edit .env with your database URL

# Run database migrations
npx prisma migrate dev

# Start development server
yarn dev

Available Scripts

# Development
yarn dev          # Start React app + Express server
yarn start        # Start React app only
yarn server       # Start Express server only

# Production
yarn build        # Build for production
yarn dist         # Build desktop app with Electron

# Database
npx prisma studio # Open database GUI
npx prisma migrate # Run database migrations

πŸ“± Usage

Dashboard

  • Today's Progress: View completed vs total tasks
  • Journal Preview: See your latest journal entry
  • Weekly Productivity: Track completion trends

Tasks

  • Add Tasks: Type and press Enter or click Add
  • Edit Tasks: Click the pencil icon to edit inline
  • Delete Tasks: Click trash icon, then confirm
  • Mark Complete: Check the checkbox to toggle status

Journal

  • Write Entries: Use the large text area
  • Edit Entries: Click pencil icon to modify
  • Delete Entries: Click trash icon with confirmation
  • Search: Filter entries by typing in search box

Insights

  • Last Week's Progress: Compare with current week
  • Journal History: Review past entries
  • Productivity Trends: Visual data analysis

πŸ–₯️ Desktop App

PWA Installation (Instant)

  1. Open the app in Chrome/Safari
  2. Click the "Install" button in the address bar
  3. Your app is now a desktop application!

Electron Build (Advanced)

# Build desktop installer
yarn dist

# Available for:
# - macOS (.dmg)
# - Windows (.exe) 
# - Linux (.AppImage)

πŸš€ Deployment

Vercel (Recommended)

# Deploy to Vercel
vercel

# Set environment variables in Vercel dashboard:
# DATABASE_URL=your_postgres_connection_string

Manual Deployment

# Build the app
yarn build

# Deploy build folder to your hosting service

πŸ—„οΈ Database Schema

Tasks

- id: Int (Primary Key)
- text: String
- completed: Boolean
- date: DateTime
- createdAt: DateTime

Journal Entries

- id: Int (Primary Key)
- text: String
- date: DateTime
- createdAt: DateTime

πŸ”§ Configuration

Environment Variables

DATABASE_URL="postgresql://user:password@host:port/database"
PORT=5001
NODE_ENV=production
REACT_APP_API_PORT=5001

Customization

  • App Icon: Replace public/logo.png
  • Theme Colors: Edit CSS variables in src/index.css
  • Window Size: Modify public/electron.js for desktop app

🀝 Contributing

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

πŸ“„ License

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


πŸ™ Acknowledgments

  • Built as part of the journey from junior to senior developer
  • Inspired by modern productivity tools
  • Thanks to the React and Node.js communities

Made with ❀️ by [Your Name]

Transform your productivity journey with G-Tracker!

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages