48 lines
2.1 KiB
Markdown
48 lines
2.1 KiB
Markdown
# 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 for that add a Dark/Light themeing capability out of the box. 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](web/style/readme.md)_
|
|
|
|
## 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:
|
|
|
|
```bash
|
|
git clone https://forge.happytavern.co/oceanslim/gostart.git
|
|
```
|
|
|
|
2. Navigate to the project directory:
|
|
|
|
```bash
|
|
cd GoStart
|
|
```
|
|
|
|
3. Setup your configuration
|
|
|
|
```bash
|
|
cp config.example.json config.json
|
|
```
|
|
|
|
4. Build and run the application:
|
|
|
|
```bash
|
|
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](LICENSE).
|