Skip to content
Notifications You must be signed in to change notification settings

aramb-dev/aram-tutorials

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ec54754 · · Aug 16, 2025

History

55 Commits
Aug 7, 2025
Aug 12, 2025
Aug 16, 2025
Aug 4, 2025
Aug 13, 2025
Aug 16, 2025
Aug 16, 2025
Aug 7, 2025
Aug 7, 2025
Aug 16, 2025
Aug 7, 2025
Aug 13, 2025
Aug 7, 2025
Aug 7, 2025
Aug 13, 2025
Aug 13, 2025
Aug 16, 2025
Aug 16, 2025
Aug 7, 2025
Aug 16, 2025
Aug 14, 2025

Repository files navigation

Aram Tutorials

🚀 Tech Made Simple - A modern educational platform for developers and tech enthusiasts.

About Aram Tutorials

Aram Tutorials is a comprehensive learning platform launched in August 2024, dedicated to making complex technology concepts accessible to everyone. With over 5,700+ views and 21 curated tutorials, we've built a thriving community of learners passionate about web development, programming, and emerging technologies.

Project Purpose & Core Functionalitylity

This Next.js-powered platform serves as both an educational resource and a showcase of modern web development practices. Our mission is to bridge the gap between complex technical concepts and practical, real-world applications through clear, step-by-step tutorials and authentic learning experiences.

Built With

This platform was crafted using modern development tools and practices:

  • TRAE Solo - Advanced development environment and deployment platform
  • Kilo Code - Professional code management and optimization tools
  • GitHub Copilot - AI-powered code completion and development assistance

These tools enabled rapid development while maintaining high code quality and modern best practices throughout the entire development lifecycle.

Key Features

  • Blog: A feature-rich blog with components for individual posts, comments, categories, and related post suggestions.
  • Tutorials: A dedicated section for tutorials, complete with filtering and listing capabilities.
  • Contact Page: Includes a contact form for user inquiries and an FAQ section.
  • About Page: A comprehensive "About Me" section detailing personal story, skills, and professional experience.
  • Home Page: A well-structured landing page with a hero section, featured posts, and a newsletter subscription form.
  • Custom UI Library: A set of reusable UI components, indicating a consistent design system.

Installation & Dependenciescies

Installation

To get started, clone the repository and install the dependencies:

git clone https://github.com/aramb-dev/aram-tutorials.git

cd aram-tutorials
npm installl

Running the Development Server

Run the following command to start the development server:

npm run dev

Open http://localhost:3000 with your browser to see the result.

Building for Production

To create a production build, run:

npm run build

Starting the Production Server

To start the production server, run:

npm run start

Key Dependencies

  • Core: next, react, react-dom
  • Database: @neondatabase/serverless
  • Authentication: next-auth
  • UI: @radix-ui/*, tailwindcss
  • Forms: zod, react-hook-form

Configuration

The next.config.ts file is configured to allow images from the following remote domains:

  • trae-api-us.mchost.guru
  • images.unsplash.com
  • via.placeholder.com

Contributing

We welcome contributions to improve the project. Please follow these guidelines:

  • Bug Reports: If you find a bug, please open an issue with a detailed description, steps to reproduce, and expected behavior.
  • Feature Suggestions: Have an idea for a new feature? Open an issue to discuss it.
  • Pull Requests: We welcome pull requests. Please ensure your code follows the project's coding standards and includes tests where applicable.

Roadmap

Here are some of the planned enhancements for the future:

Content & Learning Experienceence

  • Interactive Code Playground: Embed live code editors for hands-on learning
  • Video Tutorial Integration: Add video content alongside written tutorials
  • Tutorial Series: Group related tutorials into comprehensive learning paths
  • Difficulty Levels: Add beginner, intermediate, and advanced skill indicators
  • Progress Tracking: Allow users to track their learning progress through tutorials

Platform Features

  • User Authentication: Implement user accounts for personalized experiences
  • Bookmarking System: Let users save favorite tutorials for later
  • Tutorial Search: Advanced search with filters by technology, difficulty, and date
  • Comments & Discussion:ion: Enhanced commenting system with replies and reactions
  • Newsletter Automation: Automated weekly digest of new tutorials and updates

Technical Improvements

  • Mobile App: React Native companion app for on-the-go learning
  • Offline Reading: PWA features for offline tutorial access
  • Performance Optimization: Image optimization and lazy loading enhancements
  • Accessibility Improvements: Full WCAG 2.1 AA compliance
  • SEO Enhancement: Advanced meta tags and structured data implementation

Community & Engagementment

  • Guest Author Program: Feature tutorials from community contributors
  • Tutorial Requests: Allow users to request specific topics
  • Code Challenges: Weekly coding challenges related to tutorial content
  • Community Discord: Dedicated Discord server for discussions and support
  • Tutorial Analytics: Detailed insights into popular content and user engagement

License

This project is licensed under the MIT License.

Contact

For any inquiries or support, please reach out via:

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published