Accelerated Golang Course - ADHD-Friendly Learning Platform

A modern, containerized learning platform for transitioning from Python/TypeScript to Go, designed with ADHD-friendly features and built with Tailwind CSS for responsive design.

• 🎯 ADHD-Friendly Design: 45-minute focused sessions with break reminders
• 🌙 Full Dark Mode: Complete dark/light theme support with Tailwind CSS
• 📱 Responsive Design: Mobile-first design that works on all devices
• 💾 Persistent Progress: PostgreSQL database with Docker volumes for data persistence
• 🔄 Real-time Sync: Progress automatically saved and synced across sessions
• 🎨 Modern UI: Built with Tailwind CSS for beautiful, accessible design
• 🐳 Docker Ready: Fully containerized with Docker Compose

• Docker and Docker Compose installed on your system
• Git (to clone the repository)

git clone <repository-url>
cd golang_course_guide

Copy the example environment file and customize if needed:

cp .env.example .env

The default configuration works out of the box with Docker Compose.

# Build and start all services
docker-compose up --build

# Or run in detached mode
docker-compose up --build -d

• Application: http://localhost:3000
• Database: localhost:5432 (if you need direct access)

# Stop services
docker-compose down

# Stop and remove volumes (⚠️ This will delete all data)
docker-compose down -v

For development with hot reloading:

# Start only the database
docker-compose up postgres -d

# Install dependencies locally
npm install

# Run development server with CSS watching
npm run dev

1. Install Dependencies:

   npm install

2. Setup PostgreSQL:

   • Install PostgreSQL locally
   • Create database: golang_course
   • Update .env with your database credentials

3. Build CSS:

   npm run build:css

4. Start Application:

   npm start

golang_course_guide/
├── public/                 # Static files served by Express
│   ├── index.html         # Main HTML file with Tailwind classes
│   ├── app.js            # Frontend JavaScript with API integration
│   └── style.css         # Generated Tailwind CSS
├── src/                   # Source files for building
│   └── input.css         # Tailwind CSS input file
├── models/               # Database models (Sequelize)
│   ├── index.js         # Database connection and associations
│   ├── UserProgress.js  # User progress tracking
│   ├── CompletedSection.js # Completed sections
│   └── UserSettings.js  # User preferences
├── routes/              # API routes
│   └── progress.js     # Progress tracking endpoints
├── scripts/            # Database and utility scripts
│   └── init-db.sql    # Database initialization
├── server.js          # Express server setup
├── Dockerfile         # Docker container configuration
├── docker-compose.yml # Multi-container setup
├── tailwind.config.js # Tailwind CSS configuration
└── package.json       # Dependencies and scripts

• GET /api/progress - Get user progress and settings
• PUT /api/progress/current-section - Update current section
• POST /api/progress/complete-section - Mark section as complete
• PUT /api/progress/settings - Update user settings
• GET /api/progress/stats - Get progress statistics

• GET /api/health - Application health status

• user_progress: Tracks user sessions and overall progress
• completed_sections: Records completed lessons and labs
• user_settings: Stores user preferences and settings

• PostgreSQL database with Docker volumes
• Automatic schema creation via Sequelize
• Data persists across container restarts

The application uses Tailwind CSS for styling. To customize:

1. Edit tailwind.config.js for theme customization
2. Modify src/input.css for custom components
3. Rebuild CSS: npm run build:css

Dark mode is implemented using Tailwind's class-based strategy:

• Toggle via the theme button in the header
• Preference saved to database and localStorage
• All components support both light and dark themes

The application is mobile-first with breakpoints:

• xs: 475px and up
• sm: 640px and up
• md: 768px and up (tablet)
• lg: 1024px and up (desktop)
• xl: 1280px and up (large desktop)

1. Port Already in Use:

   # Check what's using port 3000
   lsof -i :3000
   # Kill the process or change the port in docker-compose.yml

2. Database Connection Issues:

   # Check if PostgreSQL container is running
   docker-compose ps
   # View logs
   docker-compose logs postgres

3. CSS Not Loading:

   # Rebuild CSS
   npm run build:css
   # Or rebuild the entire container
   docker-compose up --build

# View application logs
docker-compose logs app

# View database logs
docker-compose logs postgres

# Follow logs in real-time
docker-compose logs -f app

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test with Docker: docker-compose up --build
5. Submit a pull request

MIT License - see LICENSE file for details.