Build high-performance apps swiftly with minimal team resources in GO.

The project (for now) is in the experimental phase.

• SUPERKIT
  • Table of content
• Installation
• Getting started
  • Application structure
    • assets
    • conf
    • db
    • events
    • handlers
    • types
    • views
  • Development server
  • Hot reloading the browser
• Migrations
  • Create a new migration
  • Migrate the database
  • Reset the database
  • Seeds
• Creating views with Templ
• Validations
• Testing
  • Testing handlers
• Create a production release

Create your SUPERKIT project in a single command:

go run github.com/anthdm/superkit@master [yourprojectname]

You can now navigate to your project:

cd [myprojectname]

Run npm install to install both tailwindcss and esbuild locally.

npm install

If you run into dependency issues you can run:

go clean -modcache && go get -u ./...

If you have the authentication plugin enabled you need to migrate your database.

make db-up

You can run the development server with the following command:

make dev 

Hot reloading is configured by default when running your application in development.

NOTE: on windows or on in my case (WSL2) you might need to run make watch-assets in another terminal to watch for CSS and JS file changes.

make db-mig-create add_users_table

The command will create a new migration SQL file located at app/db/migrations/add_users_table.sql

make db-up

make db-reset

make db-seed

This command will run the seed file located at cmd/scripts/seed/main.go

superkit uses Templ as its templating engine. Templ allows you to create type safe view components that renders fragments of HTML. In-depth information about Templ can be found here: Templ documentation

todo

superkit will compile your whole application including its assets into a single binary. To build your application for production you can run the following command:

make build

This will create a binary file located at /bin/app_prod.

Make sure you also set the correct application environment variable in your .env file.

SUPERKIT_ENV = production