Skip to content

Latest commit

Β 

History

5 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

FirstCommit LifeOS

A simple personal productivity workspace for students and beginners β€” manage your tasks, notes, goals, reminders, and get help from a local AI assistant in one place.

FirstCommit LifeOS is a lightweight productivity dashboard designed to help students organize their everyday work without needing a complicated productivity system.

The application brings tasks, notes, goals, reminders, and an AI-powered assistant together in a clean and beginner-friendly interface.

Features

Dashboard

  • Overview of your productivity workspace
  • Quick access to tasks, notes, goals, and reminders
  • Productivity statistics
  • Quick actions for commonly used features

Task Management

  • Add new tasks
  • Set task priority
  • Set due dates
  • Mark tasks as completed
  • Delete tasks
  • View task completion status

πŸ“ Notes

  • Create notes
  • Create and manage personal notes
  • Store ideas, study notes, and important information
  • Notes are preserved locally

Goals

  • Create personal goals
  • Add goal descriptions
  • Track goal progress
  • Visual progress indicators

Reminders

  • Create reminders
  • Set reminder times
  • Enable or disable reminders
  • Keep important activities organized

AI Assistant

  • Built-in productivity assistant
  • Helps with planning and everyday productivity questions
  • Provides suggestions based on your workspace
  • Works locally with predefined responses
  • No external AI API is required

Authentication

  • Email/password authentication
  • Sign up and sign in
  • Google authentication
  • Powered by Supabase Authentication

Local Data Storage

  • Tasks, notes, goals, and reminders are stored using browser local storage
  • Your productivity data remains available between sessions on the same browser

Responsive Design

  • Desktop-friendly interface
  • Mobile-friendly layout
  • Responsive sidebar and navigation
  • Clean and accessible UI

Tech Stack

  • React β€” Frontend UI
  • Vite β€” Development and build tool
  • JavaScript β€” Application logic
  • CSS β€” Styling and responsive design
  • Lucide React β€” Icons
  • Supabase β€” Authentication
  • Vercel β€” Deployment
  • LocalStorage β€” Local productivity data persistence

Project Structure

firstcommit-lifeos/
β”œβ”€β”€ public/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ App.jsx
β”‚   β”œβ”€β”€ App.css
β”‚   β”œβ”€β”€ main.jsx
β”‚   └── supabase.js
β”œβ”€β”€ .env
β”œβ”€β”€ package.json
β”œβ”€β”€ vite.config.js
└── README.md

Getting Started

Prerequisites

Make sure you have installed:

  • Node.js
  • npm
  • Git

1. Clone the repository

git clone https://github.com/nivaas219/firstcommit-lifeos.git

2. Open the project

cd firstcommit-lifeos

3. Install dependencies

npm install

4. Configure Supabase

Create a .env file in the project root:

VITE_SUPABASE_URL=your_supabase_url
VITE_SUPABASE_PUBLISHABLE_KEY=your_supabase_publishable_key

Replace the values with your Supabase project credentials.

Note: Never commit your private Supabase service-role key or other sensitive credentials to GitHub.

5. Start the development server

npm run dev

The application will be available at:

http://localhost:5173

6. Build for production

npm run build

7. Preview the production build

npm run preview

Supabase Setup

FirstCommit LifeOS uses Supabase for authentication.

To configure authentication:

  1. Create a project in Supabase.
  2. Copy the project URL.
  3. Copy the publishable/anonymous client key.
  4. Add them to your .env file.
  5. Enable the authentication providers you want to use.
  6. For Google authentication, configure the Google OAuth provider in Supabase.

The application uses Supabase Authentication while productivity data such as tasks, notes, goals, and reminders is handled locally in the browser.


Live Demo

Live Application: https://firstcommit-lifeos.vercel.app/

If the deployed URL is different, replace the URL above with the final Vercel deployment URL before submitting.


GitHub Repository

Source Code: https://github.com/nivaas219/firstcommit-lifeos


Design Goals

FirstCommit LifeOS was designed with a few simple principles:

  • Keep productivity tools simple
  • Avoid unnecessary complexity
  • Make the interface beginner-friendly
  • Provide useful information at a glance
  • Keep important actions easy to access
  • Make the application responsive across screen sizes

Why FirstCommit LifeOS?

Students often use multiple applications to manage their daily work β€” one for notes, another for tasks, another for reminders, and another for planning.

FirstCommit LifeOS brings these basic productivity needs into a single workspace.

The goal is not to create an overwhelming productivity platform, but to provide a simple personal operating system for everyday student life.


Built For

FirstCommit LifeOS is especially useful for:

  • Students
  • Beginners learning productivity systems
  • Developers managing personal tasks
  • Students working on projects
  • Anyone who wants a simple personal dashboard

Privacy

The application is designed to keep personal productivity data simple and local.

Tasks, notes, goals, and reminders are stored in the browser using LocalStorage.

Authentication is handled through Supabase.

No external AI service is required for the built-in assistant.


Contributing

Contributions, suggestions, and improvements are welcome.

To contribute:

  1. Fork the repository.
  2. Create a new branch.
git checkout -b feature/your-feature
  1. Make your changes.
  2. Test the application.
  3. Commit your changes.
git add .
git commit -m "feat: improve productivity experience"
  1. Push your branch.
git push origin feature/your-feature
  1. Open a Pull Request.

πŸ“„ License

This project is open source and available under the license included in the repository.


πŸ‘₯ Contributors

Nivaas V

Project creator and developer.

Built with React, Vite, Supabase, and a lot of curiosity about building useful software.


⭐ Acknowledgements

  • React
  • Vite
  • Supabase
  • Lucide React
  • Vercel
  • The open-source community

πŸš€ Future Improvements

Possible future improvements include:

  • Task history
  • More language/localization support
  • Advanced task filtering
  • Calendar integration
  • Cloud synchronization for productivity data
  • More intelligent AI assistance
  • Notifications and scheduled reminders
  • Additional productivity analytics

Made With Passion

FirstCommit LifeOS was created as a beginner-friendly productivity project with the goal of making everyday organization simpler.

Plan better. Focus better. Build better.

Releases

Packages

Contributors

Languages