GoStart/readme.md
2024-05-29 11:33:00 -04:00

2.1 KiB

GoStart

This is a basic starter project for building web applications using Go, Tailwind CSS, and htmx. It provides a foundation for creating interactive and responsive web applications without relying on any third-party dependencies, utilizing only the packages included with the Go language by default. This module includes a minified version of HTMX and a Custom Tailwind css, so it does not depend on having ANY external programs or CDNs. If you would like to change the default styling of the app beyond the default tailwind components, you will need the standalone Tailwind Executable to rebuild the CSS to your liking.
-More information on custom styling can be found in the Style readme

Features

  • Go: The project is built using Go, a powerful and efficient programming language for building scalable and high-performance applications.
  • Tailwind CSS: Tailwind CSS is used for styling the web application, providing a utility-first CSS framework that enables rapid UI development.
  • htmx: htmx is a lightweight library that allows you to add interactive features to your web pages without writing JavaScript, enabling server-side rendering and reducing the need for complex client-side code.
  • Bring Your Own Database: This starter project does not include a specific database implementation, allowing you to choose and integrate the database solution that best fits your project's requirements.

Getting Started

  1. Clone the repository:

    git clone https://forge.happytavern.co/oceanslim/gostart.git
    
  2. Navigate to the project directory:

    cd GoStart
    
  3. Setup your configuration

    cp config.example.json config.json
    
  4. Build and run the application:

    go run .
    

    The application will be accessible at http://localhost:8787, or whatever port you set in your configuration.

Contributing

Contributions to this project are welcome! If you find any issues or have suggestions for improvements, please open an issue or submit a pull request.

License

This project is licensed under the MIT License.