Edgeworks Timesheet

A modern timesheet management application built with React, TypeScript, and Supabase.

Features

• 🔐 User Authentication - Secure login, registration, and password reset
• ⏱️ Timesheet Management - Track time entries for different projects and clients
• 📊 Reporting - Generate and export reports with data visualization
• 👥 Project Management - Organize work by clients and projects
• 📈 Data Visualization - Interactive charts powered by Recharts
• 📤 Export Functionality - Export timesheets to Excel format

Tech Stack

• Frontend: React 19, TypeScript, Vite
• Backend: Supabase (Authentication & Database)
• UI Components: Custom components with Lucide React icons
• Charts: Recharts
• State Management: React Context API

Prerequisites

• Node.js (v18 or higher)
• Bun (or npm/yarn)
• Supabase account

Setup

1. Clone the repository

   git clone https://github.com/salvatoreiannola72/timetracker.git
   cd timetracker

2. Install dependencies

   bun install
   # or
   npm install

3. Configure environment variables

   Create a .env file in the root directory with your Supabase credentials:

   VITE_SUPABASE_URL=your_supabase_url
   VITE_SUPABASE_ANON_KEY=your_supabase_anon_key

4. Run the development server

   bun run dev
   # or
   npm run dev

5. Open the app

   Navigate to http://localhost:5173 in your browser

Deploy to Heroku

This application is configured to run on Heroku with dynamic port binding.

1. Install Heroku CLI

   Download and install from https://devcenter.heroku.com/articles/heroku-cli

2. Login to Heroku

   heroku login

3. Create a new Heroku app

   heroku create your-app-name

4. Set environment variables

   heroku config:set VITE_SUPABASE_URL=your_supabase_url
   heroku config:set VITE_SUPABASE_ANON_KEY=your_supabase_anon_key

5. Deploy to Heroku

   git push heroku main

6. Open your app

   heroku open

The application uses:

• Express server (server.js) to serve the built React app
• Dynamic PORT from Heroku's environment variable
• Procfile to specify the start command

Build for Production

bun run build
# or
npm run build

The production-ready files will be in the dist folder.

Project Structure

├── components/         # Reusable UI components
├── context/           # React Context for state management
├── lib/               # Utility functions and Supabase client
├── pages/             # Application pages/routes
├── public/            # Static assets
├── supabase/          # Supabase configuration
└── types.ts           # TypeScript type definitions

License

Private project - All rights reserved