If you find Linux Path helpful and want to support its development, consider buying me a coffee! Your support helps keep this project alive and enables continuous improvements to help more people learn Linux.

• 🐧 Interactive Linux Learning: Step-by-step lessons covering Linux fundamentals
• 🌍 Multi-language Support: Built with internationalization (i18n) using next-intl
• 📚 Comprehensive Curriculum: Structured chapters covering everything from basics to advanced topics
• 🎯 Interactive Exercises: Hands-on practice with real Linux commands
• 📱 Responsive Design: Beautiful, modern interface that works on all devices
• 🔧 Easy Deployment: Multiple deployment options including Docker
• 📖 JSON-Based Content: Flexible content management through JSON dictionaries
• 🚀 Fast Performance: Built with Next.js for optimal loading times

Here are the exciting features coming to Linux Path:

Legend:

• 🔄 In Development
• 📋 Planned
• 💡 Research Phase
• ✅ Complete

Linux Path uses a sophisticated dictionary system for content management and internationalization. For detailed information, see the Dictionary Documentation.

Unfortunately, I am a native Italian speaker, so I cannot guarantee the accuracy or naturalness of the translations in other languages.

Choose one of the following:

• Node.js: 18.0+ and npm (for local development)
• Docker: Latest version (for containerized deployment)

1. Clone the repository:

   git clone https://github.com/daquino94/linux-path.git
   cd linux-path

2. Install dependencies:

   npm install

3. Start the development server:

   npm run dev

4. Open your browser: Navigate to http://localhost:3000

1. Clone and install (same as above steps 1-2)

2. Build the application:

   npm run build

3. Start the production server:

   npm start

1. Clone the repository:

   git clone https://github.com/daquino94/linux-path.git
   cd linux-path

2. Run with Docker Compose:

   docker-compose up -d

1. Build the Docker image:

   docker build -t linux-path .

2. Run the container:

   docker run -d \
     --name linux-path \
     -p 3000:3000 \
     -e NODE_ENV=production \
     linux-path

The project uses a sophisticated multi-stage Docker build process:

• Stage 1 (Builder): Compiles and builds the Next.js application
• Stage 2 (Runner): Creates a lean production image with only necessary files

This approach results in:

• ✅ Smaller final image size
• 🔒 Enhanced security (no build tools in production)
• ⚡ Faster deployment times
• 🧹 Cleaner production environment

• Frontend Framework: Next.js 15+ with App Router
• Language: TypeScript for type safety
• Styling: Tailwind CSS for responsive design
• Internationalization: next-intl for multi-language support
• Content Management: JSON-based dictionary system
• Containerization: Docker with multi-stage builds

The application can be configured using the following environment variables:

Create a .env.local file in the root directory:

NODE_ENV=development
NEXT_PUBLIC_APP_URL=http://localhost:3000

please refer to this documentation

We welcome contributions! Here's how you can help:

1. 🌍 Translations: Help translate content to new languages
2. 📝 Content: Improve existing lessons or add new ones
3. 🐛 Bug Reports: Report issues you encounter
4. 💡 Feature Requests: Suggest new features
5. 🔧 Code: Submit pull requests with improvements

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Make your changes: Follow the coding standards
4. Test thoroughly: Ensure everything works correctly
5. Commit your changes: git commit -m 'Add amazing feature'
6. Push to branch: git push origin feature/amazing-feature
7. Open a Pull Request: Describe your changes clearly

• 📖 Documentation: Check the Dictionary Documentation
• 🐛 Issues: Report bugs on the GitHub Issues page
• 💬 Discussions: Join conversations in GitHub Discussions
• 📧 Contact: Reach out to the maintainers

This project is licensed under the CC-BY-SA-4.0 License - see the LICENSE file for details.

• 🙋 LinuxJourney: Original inspiration for this project
• 🐧 Linux Community: For the wealth of knowledge and support
• 👥 Contributors: Everyone who has contributed to making this project better
• 🌟 Users: All the learners who use this platform to master Linux