Atlas Coup is a full-stack personal productivity platform. Sign in once — and get a unified dashboard for tracking habits, managing tasks, setting goals, journalling daily, and visualising your progress over time. No subscriptions, no clutter. Just you and your data.

It uses Firebase Authentication for secure sign-in, Firestore as the real-time database, and a polished React + Vite frontend with smooth Framer Motion animations and a dark-first UI.

• Habit Tracker — build streaks, track consistency over time
• Task Manager — create, organise, and complete daily tasks
• Goal Setting — define long-term goals and track progress
• Journal — write daily entries and reflect on your journey
• Analytics Dashboard — visualise your productivity trends
• User Dashboard — personalised overview of everything at a glance
• Smooth Animations — Framer Motion transitions throughout
• Dark-first UI — deep #050811 background, Quicksand typeface
• Zero ads · Zero tracking · Zero paywalls

• Node.js 18.x or higher
• npm / yarn / pnpm
• A Firebase project (free Spark plan works)

# Clone the repo
git clone https://github.com/code2ahm/atlascoup.git
cd atlascoup
# Install dependencies
npm install

1. Go to console.firebase.google.com and create a project
2. Enable Authentication (Email/Password or Google)
3. Enable Firestore Database (start in test mode)
4. Copy your Firebase config into src/lib/firebase.js:

const firebaseConfig = {
 apiKey: "YOUR_API_KEY",
 authDomain: "YOUR_PROJECT.firebaseapp.com",
 projectId: "YOUR_PROJECT_ID",
 storageBucket: "YOUR_PROJECT.appspot.com",
 messagingSenderId: "YOUR_SENDER_ID",
 appId: "YOUR_APP_ID"
};

npm run dev

Open http://localhost:5173.

npm run build
npm run preview

# Install Firebase CLI
npm install -g firebase-tools
# Login and initialise
firebase login
firebase init hosting
# Deploy
npm run build
firebase deploy

The project already includes .firebaserc and firebase.json — just connect your Firebase project ID and deploy.

Since Atlas Coup is a pure client-side Vite app, it deploys to any static host:

npm run build
# Upload the `dist/` folder to any static host

• Pomodoro timer integrated with tasks
• Habit streak heatmap (GitHub-style)
• Goal milestones & sub-goals
• Journal mood tagging & sentiment trends
• Export data to JSON / CSV
• PWA support for offline use
• Dark / light theme toggle

Pull requests are welcome. For major changes, open an issue first.

# Fork and clone
git clone https://github.com/your-username/atlascoup.git
cd atlascoup
# Create a feature branch
git checkout -b feat/your-feature
# Make changes, then
npm run build
# Push and open a PR
git push origin feat/your-feature