PHPackages jcergolj/simpletimer - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. jcergolj/simpletimer Active[Utility & Helpers](/categories/utility) jcergolj/simpletimer ==================== 00[7 issues](https://github.com/jcergolj/simpletimer/issues)BladeCI failing Pushed 1mo agoCompare [ Source](https://github.com/jcergolj/simpletimer)[ Packagist](https://packagist.org/packages/jcergolj/simpletimer)[ RSS](/packages/jcergolj-simpletimer/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependenciesVersionsUsed By (0) SimpleTimer =========== [](#simpletimer) **SimpleTimer — a simple time tracking web app. Don't spend time tracking time.** Timer • Clients • Projects • Reports A simple time tracking web app for freelancers and consultants who bill by the hour. Self-host forever. Built with Laravel 12 and Hotwire. [O'Saasy licensed](https://osaasy.dev/)—free to self-host forever, SaaS rights reserved. **Create a client. Add a project. Start timing. Under 30 seconds—all from your dashboard.** No page hopping. No context switching. No setup ceremony. [![SimpleTimer Dashboard](public/screenshots/dashboard.png)](public/screenshots/dashboard.png) Demo ---- [](#demo) [![SimpleTimer Demo](https://camo.githubusercontent.com/6c09430d710ffba8977843bf05fb42821c3dc2c6ab9c81d8922dcd8c1f8b7d8c/68747470733a2f2f696d672e796f75747562652e636f6d2f76692f6941644b3043335a75754d2f6d617872657364656661756c742e6a7067)](https://www.youtube.com/watch?v=iAdK0C3ZuuM) Why SimpleTimer? ---------------- [](#why-simpletimer) Most time trackers overwhelm you with 100+ features you'll never use. SimpleTimer is a simple web app that gives you exactly what you need—timer, clients, projects, reports—nothing more. **Own your data. Pay nothing. Forever.** Sound Familiar? --------------- [](#sound-familiar) **Paying $15/month for features you never use?****Spending more time starting timers than actually working?****Worried about privacy and who sees your data?** **SimpleTimer gives you exactly what you need—nothing more, nothing less.** Why Self-Host Your Time Tracker? -------------------------------- [](#why-self-host-your-time-tracker) Self-hosting isn't just about saving money—it's about control, privacy, and freedom from vendor lock-in. Traditional SaaS TrackersSimpleTimer (Self-Hosted)✗ Recurring subscriptions forever✓ **$0 forever**✗ 100+ features built for teams, forced on solo users✓ **4 core features**: Timer, Clients, Projects, Reports✗ Navigate 5+ pages to start tracking✓ **Dashboard-only workflow** (30 seconds to first timer)✗ Vendor servers (your data, their rules)✓ **Your server** (complete data ownership & privacy)✗ Feature gates, upgrade prompts, artificial limits✓ **No limits**, no upsells, no vendor pressure✗ Closed source (black box you can't inspect)✓ **Open source** (audit every line, customize freely)✗ Vendor lock-in (data export headaches)✓ **Full control** (your database, your rules)**Self-hosting gives you complete control without ongoing costs** Deployment Modes ---------------- [](#deployment-modes) SimpleTimer supports two deployment modes to fit your needs: ### Single-User Mode (Default) [](#single-user-mode-default) Perfect for freelancers and solo consultants who want simple self-hosting. - One user, one domain, one database - Simplest setup: `SINGLE_USER_MODE=true` - No subdomain routing required - Deploy and track time in 5 minutes ### Multi-Tenant Mode [](#multi-tenant-mode) Run as a private time tracking service for your team or multiple freelancers. - Each user gets isolated subdomain + database (e.g., `alice.yourdomain.com`) - Database-per-tenant: Complete data isolation - Users register on main domain, work on subdomains - Toggle with `SINGLE_USER_MODE=false` - Requires wildcard DNS (\*.yourdomain.com) **Choose based on your use case:** - Solo freelancer self-hosting? → Single-User Mode - Small agency or multiple users? → Multi-Tenant Mode - Want to offer time tracking to clients? → Multi-Tenant Mode Features -------- [](#features) ### Dead Simple Tracking [](#dead-simple-tracking) **Create client → Add project → Start timer. 30 seconds. No page hopping.** - ✓ Everything happens on your dashboard - ✓ Create clients and projects inline (no separate forms) - ✓ One-click start/stop - ✓ Keyboard shortcuts (Ctrl+Shift+S) - ✓ Survives page refreshes [![Running Timer](public/screenshots/running-timer.png)](public/screenshots/running-timer.png) ### Client & Project Management [](#client--project-management) **From £75/hr London projects to $100/hr NYC clients—track it all. Multi-currency built in.** - ✓ Create clients/projects inline - ✓ Set hourly rates (56 currencies) - ✓ Project rates override client rates - ✓ No setup ceremony required [![Create Client & Projects On The Fly](public/screenshots/start-tracking-with-new-project.png)](public/screenshots/start-tracking-with-new-project.png) ### Reports That Pay You [](#reports-that-pay-you) **Generate clean reports in seconds. Export to CSV, attach to invoice, get paid.** - ✓ Filter by date, client, project - ✓ CSV export for invoicing - ✓ Total hours + earnings per project - ✓ Clean format for clients [![Reports and CSV Export](public/screenshots/reports.png)](public/screenshots/reports.png) Tech Stack ---------- [](#tech-stack) **Backend:** Laravel 12, PHP 8.4, SQLite/MySQL/PostgreSQL **Frontend:** Hotwire Turbo, Stimulus, Tailwind + DaisyUI, Importmap **Testing/QA:** PHPUnit, Pint, Larastan, Rector Hotwire means SPA-like UX without heavy JS. Importmap means no build step for JavaScript. How Hard Is Self-Hosting? ------------------------- [](#how-hard-is-self-hosting) **Easier than you think. Here's what you need:** - **Works on:** DigitalOcean ($5/mo), Vultr, Linode, your laptop - **Install time:** 15 minutes - **Requirements:** PHP 8.4, Git (that's it) - **Managed option:** Laravel Forge ($12/mo handles everything) **Not technical?** Forge auto-deploys. You just click buttons. No command line required. Installation ------------ [](#installation) **Ready in 5 Minutes** If you can clone a Git repo, you can install SimpleTimer. Requires PHP 8.4+ ``` git clone cd simple ./install.sh php artisan app:create-user php artisan serve ``` **Done. You're tracking time.** > **Note:** Default setup is single-user mode. For multi-tenant setup with subdomains, see the Configuration section below. Manual install steps in `install.sh` if you prefer to do it yourself. ### Hosting Options [](#hosting-options) - **$0/month**: Your laptop or home server - **$5/month**: DigitalOcean, Linode, Vultr - **$12/month**: Laravel Forge (managed deployment) All options give you full data ownership. No vendor lock-in. Common Commands --------------- [](#common-commands) ``` # User management php artisan app:create-user php artisan user:reset-password user@email.com # Development php artisan serve php artisan migrate php artisan optimize:clear # Clear all caches when things break ``` Configuration ------------- [](#configuration) ### Single-User Mode (Default) [](#single-user-mode-default-1) Default mode for self-hosters. One user, simple setup. **Setup:** ``` # .env file (default) SINGLE_USER_MODE=true APP_URL=http://yourdomain.com # Create your account php artisan app:create-user ``` **Features:** - Registration disabled after first user - No subdomain routing - Single SQLite database - Simplest deployment **Reset password:** ``` php artisan user:reset-password your-email@example.com ``` **Testing:** Need a second user for testing? Use `php artisan app:create-user --force` ### Multi-Tenant Mode [](#multi-tenant-mode-1) Deploy for multiple users with subdomain isolation. **Requirements:** - Wildcard DNS: `*.yourdomain.com` pointing to your server - Web server configured for wildcard subdomains (see configuration below) **Setup:** ``` # .env file SINGLE_USER_MODE=false APP_URL=http://yourdomain.com APP_DOMAIN=yourdomain.com # Create template database cp database/database.sqlite database/template.sqlite php artisan migrate --database=sqlite --path=database/template.sqlite ``` **How it works:** 1. Users register at `yourdomain.com/register` 2. Registration creates isolated database at `database/db/{username}.sqlite` 3. User redirected to `{username}.yourdomain.com/dashboard` 4. All subsequent requests auto-connect to tenant database **Web server configuration:** **Nginx:** ``` server { server_name yourdomain.com *.yourdomain.com; root /path/to/simpletimer/public; # Standard Laravel config... } ``` **Apache:** ``` ServerName yourdomain.com ServerAlias *.yourdomain.com DocumentRoot /path/to/simpletimer/public # Standard Laravel config... ``` **Security:** - Each tenant has isolated SQLite database - Middleware enforces username-subdomain matching - Login only allowed on user's subdomain Usage ----- [](#usage) ### Dashboard-First Workflow [](#dashboard-first-workflow) Everything happens on your dashboard—no context switching. 1. **Start tracking:** Pick client/project from dropdown, hit play (or `Ctrl+Shift+S`) 2. **New client?** Create inline from the same dropdown—no separate page 3. **New project?** Same thing—add it while starting the timer 4. **Stop timer:** Click stop or use keyboard shortcut **From zero to tracking in under 30 seconds.** Reports page lets you filter by date, client, or project and export to CSV. Set your preferred date/time formats in Settings. ### Environment Variables [](#environment-variables) Main settings in `.env`: ``` DB_CONNECTION=sqlite APP_TIMEZONE=UTC # Set to your timezone ``` User preferences (date/time formats, hourly rates) configurable in Settings page. O'Saasy License --------------- [](#osaasy-license) **[Learn more about O'Saasy License →](https://osaasy.dev/)** **Free to self-host forever. SaaS rights reserved.** The O'Saasy License means: - ✓ **Use it freely**: Install, modify, and run SimpleTimer on your own server at no cost - ✓ **Own your data**: Full control and privacy—your data never leaves your server - ✓ **Audit the code**: Open source, inspect every line - ✓ **Extend it**: Build custom features for your own needs - ✗ **No SaaS competition**: You cannot offer SimpleTimer as a competing hosted service **Why this license?** It keeps the project sustainable while ensuring you can self-host forever without restrictions. Full license text: [LICENSE](LICENSE) Contributing ------------ [](#contributing) PRs welcome. Standard fork → branch → PR workflow. If you're good with UI/UX and want to help make it more minimal/clean, that'd be great. License ------- [](#license) [O'Saasy licensed](https://osaasy.dev/) - free to self-host forever, SaaS rights reserved. See the [O'Saasy License](#osaasy-license) section above for details. FAQ --- [](#faq) **Here's what freelancers usually ask:** ### Is it really free forever? [](#is-it-really-free-forever) Yes. O'Saasy license means free self-hosting forever. We reserve rights to offer a managed SaaS version, but the open-source stays free. ### Does it support teams or just solo users? [](#does-it-support-teams-or-just-solo-users) Both! Toggle deployment mode in your `.env` file: **Single-User Mode (`SINGLE_USER_MODE=true`)**: One user, one domain. Perfect for solo freelancers. **Multi-Tenant Mode (`SINGLE_USER_MODE=false`)**: Multiple users, subdomain isolation. Each user gets `username.yourdomain.com` with separate database. Great for small agencies or offering time tracking to clients. See the Configuration section for setup details. ### Can I migrate from Toggl/Harvest? [](#can-i-migrate-from-togglharvest) CSV import coming soon. Manual entry works today. ### What if I break it? [](#what-if-i-break-it) Support via GitHub issues. Active community. Common fixes in README. ### How often should I backup? [](#how-often-should-i-backup) Daily recommended. Simple SQLite file copy. Takes 5 seconds. Support ------- [](#support) Open an issue if something breaks. Common fixes: - Forgot password: `php artisan user:reset-password your-email@example.com` - App errors: `php artisan optimize:clear` Roadmap ------- [](#roadmap) ### Available Today [](#available-today) Everything you need to track time and get paid. No waiting. - **Timer + Shortcuts**: One-click tracking with Ctrl+Shift+S/T - **Multi-Currency**: 56 currencies, client & project rates - **CSV Exports**: Reports ready for invoicing - **Client Management**: Organize projects & clients inline ### Coming Soon [](#coming-soon) We're building features that expand SimpleTimer while maintaining our core philosophy of simplicity. #### API & Webhooks [](#api--webhooks) Programmatic access to your time tracking data. Integrate SimpleTimer with your existing tools and workflows. - RESTful API endpoints for all resources - Webhook notifications for timer events - Token-based authentication - Integrate with invoicing, project management, and more **Perfect for:** Developers who want to automate workflows and connect SimpleTimer to their existing tools. #### SaaS Hosted Version [](#saas-hosted-version) Don't want to self-host? We'll handle all the technical details for you. Same simplicity, zero server management. - Fully managed hosting - we handle everything - Automatic updates and security patches - Daily backups included - Start tracking in under 60 seconds **Perfect for:** Freelancers and consultants who want simplicity without the technical setup. --- Core stays free and open source. Optional paid features will support development, but the base app will always be O'Saasy licensed and self-hostable. **Interested in these features?** Star on [GitHub](https://github.com/jcergolj/simpletime) to stay updated. ### Health Score 18 — LowBetter than 8% of packages Maintenance59 Moderate activity, may be stable Popularity0 Limited adoption so far Community6 Small or concentrated contributor base Maturity8 Early-stage or recently created project Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Community Maintainers ![](https://www.gravatar.com/avatar/111d8d25ce610ce3d6cb7413529089ce6482e34dfc5a6a8bf04592719a0abe07?d=identicon)[jcergolj](/maintainers/jcergolj) --- Top Contributors [![jcergolj](https://avatars.githubusercontent.com/u/6940394?v=4)](https://github.com/jcergolj "jcergolj (4 commits)") ### Embed Badge ![Health badge](/badges/jcergolj-simpletimer/health.svg) ``` [![Health](https://phpackages.com/badges/jcergolj-simpletimer/health.svg)](https://phpackages.com/packages/jcergolj-simpletimer) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)