Skip to content

ndegwa007/comicshop

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Comicshop

Comicshop is an open-source web application designed for selling comic posters. It features a FastAPI backend and uses the Astro framework for the frontend. The project is still under active development, and contributions are welcome!

🚀 Project Overview

Comicshop provides a simple and user-friendly platform to browse, purchase, and manage comic posters. It aims to deliver a smooth experience for both the buyers and the administrators managing the product catalog.

🛠️ Tech Stack

  • Backend: FastAPI
  • Frontend: Astro
  • Database: PostgreSQL
  • Deployment: Docker (optional)

🔨 Features

  • Browse available comic posters.
  • Add posters to the cart.
  • Purchase posters using a simple checkout flow.
  • Admin interface to manage the product catalog (future implementation).

🚧 Project Status

This project is currently under development. Some features may be incomplete or missing. Contributions are welcome to help enhance and expand the application's functionality.

📦 Installation

  1. Clone the repository:

    git clone https://github.com/ndegwa007/swiftyapp.git
    cd swiftyapp
  2. Backend Setup:

    • Navigate to the backend directory and install dependencies:
    cd back
    python -m venv venv
    source venv/bin/activate 
    pip install -r requirements.txt
    • Start the FastAPI server:
    uvicorn main:app --reload
  3. Frontend Setup:

    • Navigate to the frontend directory and install dependencies:
    cd ../front
    npm install
    • Start the Astro development server:
    npm start
  4. Access the application:

    • Visit http://localhost:4321 to view the frontend.
    • Visit http://localhost:8000/docs for the FastAPI API documentation.

🗂️ Folder Structure

swiftyapp/
├── back/        # FastAPI backend
├── front/       # Astro frontend
└── README.md       # Project documentation

💡 Contributing

Contributions are welcome! Feel free to open an issue or submit a pull request to help improve SwiftyApp.

  1. Fork the repository.
  2. Create a new branch: git checkout -b feature/your-feature-name.
  3. Commit your changes: git commit -m 'Add some feature'.
  4. Push to the branch: git push origin feature/your-feature-name.
  5. Open a pull request.

📜 License

This project is open source and available under the MIT License.

📧 Contact

For questions or feedback, please contact ndegwa.

About

An online comic poster shop

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published