Skip to content

Repository files navigation

Descistency ⚑

Build Discipline. Achieve Consistency.

Descistency is a modern web application designed to help you build discipline through consistency. Track your goals, maintain daily habits, unlock achievements, and stay accountable as you transform your life one day at a time.

Descistency Banner

🎯 What is Descistency?

Descistency is not just another productivity appβ€”it's your personal accountability partner. Whether you're building a fitness routine, learning a new skill, working on career goals, or developing any habit, Descistency helps you:

  • Track Progress: Monitor your goals and applications in one organized dashboard
  • Build Streaks: Maintain daily consistency and watch your discipline grow stronger
  • Stay Accountable: Set tasks, get reminders, and never miss a commitment
  • Visualize Success: See your journey through interactive calendars and heatmaps
  • Earn Achievements: Unlock badges and celebrate milestones along the way
  • Get Mentorship: Access personalized guidance and accountability support (Premium tiers)

✨ Key Features

πŸ“Š Dashboard & Analytics

  • Real-time statistics and progress tracking
  • Visual progress indicators and completion rates
  • Success metrics and performance insights
  • Customizable views and filters

🎯 Goal & Application Tracking

  • Track job applications, projects, or any goal
  • Add notes, deadlines, and status updates
  • Organize by priority and category
  • Follow-up reminders and notifications

πŸ”₯ Streak System

  • Build and maintain daily consistency streaks
  • Interactive heatmap visualization (GitHub-style)
  • Streak milestones and achievements
  • Motivational progress tracking

βœ… Tasks & Daily Goals

  • Create daily and weekly tasks
  • Set custom goals and deadlines
  • Track completion rates
  • Recurring task support

πŸ“… Calendar View

  • Visualize all activities in one place
  • See tasks, goals, and progress at a glance
  • Monthly and weekly views
  • Color-coded activity indicators

πŸ† Achievement System

  • Unlock badges as you progress
  • Celebrate milestones and wins
  • Gamified experience to stay motivated
  • Share achievements with others

πŸ”” Smart Reminders

  • Never miss a commitment
  • Customizable notification preferences
  • Follow-up reminders
  • Daily goal notifications

πŸŒ™ Dark Mode

  • Beautiful dark theme for night owls
  • Automatic theme switching
  • Easy toggle in settings
  • Consistent across all pages

πŸ’Ύ Data Export

  • Export your data anytime
  • JSON format for portability
  • Privacy-focused approach
  • Own your data

πŸš€ Getting Started

Prerequisites

  • Node.js 18+ or Bun
  • npm, yarn, or bun package manager

Installation

  1. Clone the repository
git clone https://github.com/yourusername/descistency.git
cd descistency
  1. Install dependencies
npm install
# or
bun install
  1. Set up environment variables
cp .env.example .env
  1. Start the development server
npm run dev
# or
bun dev
  1. Open your browser Navigate to http://localhost:8080

πŸ› οΈ Tech Stack

Frontend

  • React 18 - UI library
  • TypeScript - Type safety
  • Vite - Build tool and dev server
  • TailwindCSS - Utility-first CSS framework
  • shadcn/ui - Beautiful component library
  • Lucide React - Icon library

State Management

  • React Hooks - Local state management
  • Context API - Global state
  • LocalStorage - Data persistence

Routing

  • React Router v6 - Client-side routing

Styling

  • TailwindCSS - Utility classes
  • CSS Variables - Theme customization
  • Animations - Smooth transitions and effects

πŸ“ Project Structure

descistency/
β”œβ”€β”€ public/              # Static assets
β”‚   β”œβ”€β”€ favicon.svg      # Site icon
β”‚   └── manifest.json    # PWA manifest
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ components/      # React components
β”‚   β”‚   β”œβ”€β”€ applications/  # Application tracking
β”‚   β”‚   β”œβ”€β”€ calendar/      # Calendar views
β”‚   β”‚   β”œβ”€β”€ dashboard/     # Dashboard widgets
β”‚   β”‚   β”œβ”€β”€ landing/       # Landing page sections
β”‚   β”‚   β”œβ”€β”€ layout/        # Layout components
β”‚   β”‚   β”œβ”€β”€ linkedin/      # LinkedIn activity
β”‚   β”‚   β”œβ”€β”€ tasks/         # Task management
β”‚   β”‚   └── ui/            # Reusable UI components
β”‚   β”œβ”€β”€ contexts/        # React contexts
β”‚   β”œβ”€β”€ hooks/           # Custom React hooks
β”‚   β”œβ”€β”€ integrations/    # Third-party integrations
β”‚   β”œβ”€β”€ lib/             # Utility functions
β”‚   β”œβ”€β”€ pages/           # Page components
β”‚   β”œβ”€β”€ types/           # TypeScript types
β”‚   β”œβ”€β”€ App.tsx          # Main app component
β”‚   β”œβ”€β”€ main.tsx         # Entry point
β”‚   └── index.css        # Global styles
β”œβ”€β”€ .env                 # Environment variables
β”œβ”€β”€ index.html           # HTML template
β”œβ”€β”€ package.json         # Dependencies
β”œβ”€β”€ tailwind.config.ts   # Tailwind configuration
β”œβ”€β”€ tsconfig.json        # TypeScript configuration
└── vite.config.ts       # Vite configuration

🎨 Features in Detail

Dashboard

The central hub showing:

  • Total goals/applications tracked
  • Active streaks and consistency metrics
  • Success rate and completion percentage
  • Recent activity feed
  • Quick action buttons

Goal Tracking

Track any type of goal:

  • Job applications
  • Fitness goals
  • Learning objectives
  • Project milestones
  • Personal development

Each entry includes:

  • Title and description
  • Status (Applied, Interviewing, Offer, Rejected)
  • Company/Category
  • Date applied/started
  • Notes and updates
  • Follow-up reminders

Streak Heatmap

Visual representation of your consistency:

  • GitHub-style contribution graph
  • Color intensity shows activity level
  • Hover for daily details
  • Motivational streak counter
  • Milestone celebrations

Task Management

Organize your daily work:

  • Create tasks with deadlines
  • Mark as complete
  • Set priority levels
  • Recurring tasks
  • Task categories

Calendar Integration

See everything in one view:

  • Monthly calendar layout
  • Color-coded activities
  • Click to see details
  • Filter by type
  • Export to external calendars

πŸ’Ž Premium Features

Standard Tier ($9.99/month)

  • Unlimited goals and tasks
  • Personalized task assignments
  • Advanced analytics
  • Priority support (24hr response)
  • Monthly group accountability sessions
  • Progress reviews (1x/month)
  • Ad-free experience

Exclusive Tier ($29.99/month)

  • Everything in Standard
  • Dedicated 1-on-1 mentor
  • Weekly video calls (30min)
  • Unlimited progress reviews
  • Custom accountability plans
  • Habit optimization coaching
  • Goal achievement strategies
  • Priority support (4hr response)

πŸ”’ Privacy & Security

  • Local-first: Data stored in your browser
  • No tracking: We don't track your activity
  • Export anytime: Download your data in JSON format
  • No ads: Clean, distraction-free experience
  • Open source: Transparent codebase

🀝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

πŸ“ License

This project is licensed under the MIT License - see the LICENSE file for details.

πŸ™ Acknowledgments

πŸ“§ Contact & Support

πŸ—ΊοΈ Roadmap

See ROADMAP.md for planned features and improvements.


Built with ⚑ by the Descistency team

Build Discipline. Achieve Consistency. Transform Your Life.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages