Stay focused, stay organized.

Milestone is a sleek, modern time-tracking app built to help developers and professionals track, reflect on, and improve how they spend their work hours — project by project.

• ⏱️ Start/stop time tracking
• 🗂️ Project-based log organization
• 🗒️ Session notes & file attachments
• 📊 Visual heatmap analytics
• 🌙 Dark mode support
• 📱 Fully responsive design
• � User authentication
• ☁️ Cloud storage for files
• 🗄️ PostgreSQL database

• Node.js (LTS version recommended)
• npm or yarn
• PostgreSQL database
• AWS S3 bucket (for file storage)

1. Clone the repo:

   git clone https://github.com/yourusername/CodeLog.git
   cd CodeLog

2. Install dependencies:

   npm install

3. Set up environment variables:

   Copy .env.example to .env and fill in your values:

   DATABASE_URL="your-postgresql-connection-string"
   NEXTAUTH_SECRET="your-nextauth-secret"
   NEXTAUTH_URL="http://localhost:3000"
   AWS_ACCESS_KEY_ID="your-aws-access-key"
   AWS_SECRET_ACCESS_KEY="your-aws-secret-key"
   AWS_REGION="us-east-1"
   S3_BUCKET_NAME="your-bucket-name"

4. Set up the database:

   npm run db:migrate
   npm run db:seed

5. Run the dev server:

   npm run dev

1. Connect your GitHub repo to Vercel
2. Set environment variables in Vercel dashboard
3. Use Vercel Postgres for the database
4. Deploy!

The app can be deployed to any platform supporting Next.js, such as Netlify, Railway, or Heroku.

src/
├── app/
│   ├── api/              # API routes
│   ├── auth/             # Authentication pages
│   ├── dashboard/        # Dashboard page
│   ├── projects/         # Projects pages
│   └── timer/            # Timer page
├── components/           # Reusable components
├── lib/                  # Utilities and configurations
└── prisma/               # Database schema and migrations

Run the test suite:

npm run test

1. Fork the repo
2. Create a feature branch
3. Make your changes
4. Run tests
5. Submit a PR

MIT License - see LICENSE for details.

Open your browser at http://localhost:3000

• Next.js – App framework
• Tailwind CSS – Styling
• Zustand – State management
• date-fns – Date handling
• Lucide React – Icon set

/
├── src/
│   ├── app/          # App router pages
│   ├── components/   # UI components
│   └── lib/          # Stores and utilities
├── public/           # Static assets
└── ...config files

Contributions are welcome! Feel free to open issues or submit pull requests to improve CodeLog.

Licensed under the GNU Affero General Public License. See the LICENSE file for details.