{"id":28960471,"url":"https://github.com/ajao-victor/codealpha_folcommerce","last_synced_at":"2026-05-04T10:36:06.684Z","repository":{"id":300780767,"uuid":"1005620567","full_name":"Ajao-Victor/CodeAlpha_folCommerce","owner":"Ajao-Victor","description":"Hey there! Folcommerce is my passion project—a sleek e-commerce app built for smooth shopping. Browse products, check out detailed item pages, add stuff to your cart, and checkout with ease. It’s got a clean, mobile-friendly design and a solid backend. Made with HTML, CSS, JS, Node.js, Express, and PostgreSQL, plus JWT for secure logins. ","archived":false,"fork":false,"pushed_at":"2025-06-23T14:51:40.000Z","size":2387,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-06-23T15:46:11.041Z","etag":null,"topics":["api-client","axios","bcrypt","cors","css3","expressjs","html5","javascript","jwt-authentication","nodejs","postgresql-database"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Ajao-Victor.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-20T14:21:35.000Z","updated_at":"2025-06-23T14:51:43.000Z","dependencies_parsed_at":"2025-06-23T15:56:59.012Z","dependency_job_id":null,"html_url":"https://github.com/Ajao-Victor/CodeAlpha_folCommerce","commit_stats":null,"previous_names":["ajao-victor/codealpha_folcommerce"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Ajao-Victor/CodeAlpha_folCommerce","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ajao-Victor%2FCodeAlpha_folCommerce","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ajao-Victor%2FCodeAlpha_folCommerce/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ajao-Victor%2FCodeAlpha_folCommerce/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ajao-Victor%2FCodeAlpha_folCommerce/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Ajao-Victor","download_url":"https://codeload.github.com/Ajao-Victor/CodeAlpha_folCommerce/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ajao-Victor%2FCodeAlpha_folCommerce/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261584269,"owners_count":23180681,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api-client","axios","bcrypt","cors","css3","expressjs","html5","javascript","jwt-authentication","nodejs","postgresql-database"],"created_at":"2025-06-24T01:14:53.227Z","updated_at":"2026-05-04T10:36:06.636Z","avatar_url":"https://github.com/Ajao-Victor.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"    Folcommerce\nHey there! Welcome to Folcommerce, my passion project—an e-commerce platform crafted to make online shopping in Nigeria super smooth and fun. Whether you're browsing cool products, checking out detailed item pages, managing your cart, or checking out, Folcommerce has you covered with a sleek, mobile-friendly interface and a rock-solid backend. Built with love using HTML, CSS, JavaScript for the front end and Node.js/Express for the backend, it’s ready to deliver a top-notch shopping experience. Wanna give it a spin or help make it even better? Let’s dive in! 😊\nFeatures\n\nProduct Browsing: Explore a catalog of products with a handy search bar to find what you love.\nProduct Details: Click any product to see its full info—images, descriptions, and price—pulled straight from a PostgreSQL database.\nCart Management: Add items, tweak quantities, or clear your cart, with real-time updates for a seamless flow.\nCheckout: Wrap up your purchase with a clean, secure checkout process.\nSecure Authentication: JWT-based login keeps your account safe and sound.\nResponsive Design: Looks great on any device, from phones to desktops, with a modern vibe thanks to Animate.css and Font Awesome.\nAPI-Driven: Backend powered by Node.js/Express, with sample data seeded from the Fake Store API.\n\n    Tech Stack\n\n    Frontend: HTML5, CSS3, JavaScript, Animate.css, Font Awesome\nBackend: Node.js, Express.js\nDatabase: PostgreSQL\nAuthentication: JSON Web Tokens\nTools: npm, http-server` for local development\nDeployment: Ready for Netlify (frontend) and Render (backend) (optional)\n\n    Getting Started\nReady to try Folcommerce out locally? Here’s how to set it up:\nPrerequisites\n\nNode.js (v16 or higher)\nPostgreSQL (set up locally or via a cloud provider like RenderDB or Heroku)\nGit\nA browser (Chrome, Firefox, etc.)\n\n    Installation\n\nClone the Repo:\ngit clone https://github.com/Ajao-Victor/folcommerce.git\ncd folcommerce\n\n\n    Set Up the Backend:\n\nNavigate to the backend folder (if separate, e.g., backend/):cd backend\nnpm install\n\n\nCreate a .env file in the backend folder with:DATABASE_URL=your_postgres_connection_string\nJWT_SECRET=your_jwt_secret_key\n\n\nStart the backend:npm start\n\nNote: Ensure PostgreSQL is running and has products and cart_items tables (see schema below).\n\n\nSet Up the Frontend:\n\nNavigate to the frontend folder (e.g., root or frontend/):cd ../frontend\n\n\nInstall http-server globally (if not already installed):npm install -g http-server\n\n\nServe the frontend:http-server\n\n\nOpen http://localhost:8080/index.html in your browser.\n\n\nDatabase Schema:Create the required tables in PostgreSQL:\nCREATE TABLE products (\n    id INTEGER PRIMARY KEY,\n    title TEXT NOT NULL,\n    price DECIMAL NOT NULL,\n    description TEXT,\n    image_url TEXT\n);\n\nCREATE TABLE cart_items (\n    id SERIAL PRIMARY KEY,\n    user_id INTEGER NOT NULL,\n    product_id INTEGER REFERENCES products(id),\n    quantity INTEGER DEFAULT 1\n);\n\n\n    Test It Out:\n\nRegister/login to get a JWT token (stored in localStorage).\nBrowse products, add to cart, view cart, and checkout.\nUse the search bar to filter products.\n\n\n\nProject Structure\nfolcommerce/\n├── server/                 # Node.js/Express backend\n│   ├── server.js            # Main server file\n│   ├── .env                 # Environment variables\n│   └── node_modules/\n|-Client/\n|    ├── cssFiles/                # CSS styles\n│       ├── cart.css\n│       ├── checkout.css\n│       ├── index.css\n│       ├── product-detail.css\n│       └── products.css\n├── logo.png                 # App logo\n|    |-shop/\n|        ├── about.html\n|        ├── cart.html\n|        ├── checkout.html\n|        ├── contact.html\n|        ├── index.html               # Home page\n|        ├── product-detail.html\n|        ├── products.html            # Product listing\n|        ├── registration.html        # Login/registration\n|        └── services.html\n\n    Contributing\nLove the project and wanna help? Awesome! Here’s how:\n\nFork the repo.\nCreate a branch: git checkout -b feature/your-feature.\nCommit changes: git commit -m \"Add your feature\".\nPush to your fork: git push origin feature/your-feature.\nOpen a pull request with a clear description.\n\nPlease open an issue first for major changes or bugs to discuss ideas!\nKnown Issues\n\nCheckout is minimal (no payment gateway yet—Paystack integration planned).\nProduct data uses Fake Store API; custom products to be added.\nAdd error handling for edge cases (e.g., invalid tokens).\n\n    Future Plans\n\nIntegrate Paystack for payments.\nAdd user profiles and order history.\nImplement product categories and filters.\nOptimize performance with lazy-loaded images.\n\n    Contact Me\nGot questions or ideas? Reach out!\n\nEmail: svictoroluwatimileyin3@gmail.com\nPhone: +234 913 110 9245\nGitHub: Ajao-Victor\nLinkedIn: Victor Ajao or www.linkedin.com/in/victor-ajao-970771253\nLocation: Osun State, Nigeria\n\n\nThanks for checking out Folcommerce! Let’s build something amazing together. 🚀\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fajao-victor%2Fcodealpha_folcommerce","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fajao-victor%2Fcodealpha_folcommerce","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fajao-victor%2Fcodealpha_folcommerce/lists"}