We've just released a new IHP version! :)

Major Changes

• Numeric Primary Keys Supported: IHP now allows numeric (Serial in Postgres-speak) primary keys. Previously only UUIDs have been supported. UUIDs will still be the default. This feature makes it more simple to use IHP with existing databases and services.
• nl2br: A new view helper has been added in this release. With nl2br you can transform \n linebreaks to <br> line breaks. Like get #body post |> nl2br :)
• HTML Comments: HSX now supports HTML comment syntax. <!-- 🚀 -->. This has been added after someone asked for comment syntax on Stack Overflow. This was actually the first IHP-related stack overflow question we've come across.

Other Changes

• ParamReader Float and InputValue Float instances have been added for better dealing with Float values
• A bug has been fixed causing the code generator not generating input fields in freshly-generated controllers views
• We've improved CI workflows to avoid build errors on master (thanks to @ruhatch for fixing the master :))
• Improved Json support by adding a generic ToJson instance for IHP record Ids
• Documentation on how to disable the layout for a single view has been added
• Documentation on how to change the start page of a IHP app has been added
• We've improved the error messages. In the wiki we've described our error message design goals.
• Fixed a bug with findLibDir causing trouble with production deployments
• Fixed controller code generator generating view import statements twice
• Fixed deleting a column still left over the assigned foreign key constraint
• Fixed query box in Data tool not working due to javascript bug
• Fixed a bug with nullable has many relationships causing a type error in Generated.Types
• Fixed deleteRecord not working with records that have a fetched relationship
• Improved HSX error messages when dealing with invalid attribute names and fixed missing attribute names for SVGs
• Documentation on how to refactor your database (renaming columns, etc.) has been added
• Enums now have a ParamReader instance by default. This makes it easier to work with enums in forms.

Updating

To update the IHP version of your project, open default.nix and change the git commit in line 4 to the following:

rev = "0bb881e0febdf5fb8db939a6c5eb481c76a1b332";

After that run the following command to update your project:

nix-shell -j auto --cores 0 --run 'make -B .envrc'

In case nix starts rebuilding IHP (might take a while), make sure cachix is set up as expected:

cachix use digitallyinduced

Now you can start your project as usual with ./start.

If you have any problems with updating, let us know on the brand new IHP forum.

📧 To stay in the loop, subscribe to the IHP release emails. Or follow digitally induced on twitter..

📅 The next release is expected to be released on 04.09.2020.

If you're curious what we're also working on, click here 🔥

CREATE TABLE order_trucks (
    order_id BIGSERIAL NOT NULL,
    truck_id BIGSERIAL NOT NULL,
    PRIMARY KEY(order_id, truck_id)
);

• SQL Logging only in dev mode: IHP will now not log sql queries when it's running in production mode.

• Improved Data Tool in the Dev Tooling: The database access tool (below the Schema Editor in the IHP navigation) now makes more efficient use of screen space. We made a few small changes to improve the overall usability of the tool.

• More documentation:

  • Rendering JSON
  • Getting a Id Something from a UUID
  • Select Inputs with Custom Enums
  • StackOverflow #ihp is linked now in the Guide Navigation
  • Building a script
  • HSX: Empty Attributes
  • Making a dynamic Login/Logout button

Other Changes

- The primary haskell json library aeson is now exported by the ViewPrelude by default. No need to manually import it in your views anymore. - A code generation issue caused by having a table with two foreign keys referencing the same foreign table has been fixed. - An issue encoding with enums using multibyte characters has been resolved - The CREATE EXTENSION IF NOT EXISTS "uuid-ossp"; is not required in your app's Schema.sql anymore. It's automatically loaded by IHP. - Support for empty attributes in HSX like <input disabled/> has been added. - Grammar fixes - The make target build/bin/RunOptimizedProdServer now correctly depends on build/Generated/Types.hs. The target build/bin/RunUnoptimizedProdServer already has this dependency. - Dotless Emails are now validated correctly - All IHP binaries are now compiled with -threaded. Somehow we missed this. This improves the performance of the dev server. - The default ghci prompt of a IHP is now a lambda symbol - make targets for compiling IHP scripts have been added - a naming issue causing request not being easily useable in actions has been resolved

• The release versioning scheme has changed from vDDMMYYYY to vYYYYMMDD starting with this version.

Updating

To update the IHP version of your project, open default.nix and change the git commit in line 4 to the following:

rev = "a12a1ce8f16814b802aae39eb26a9d3247192c12";

After that run the following command to update your project:

nix-shell -j auto --cores 0 --run 'make -B .envrc'

Now you can start your project as usual with ./start.

In case you get a compiler error about a missing field in ModelContext in the auto-generated build/Generated/Types.hs please stop your application and do a clean rebuild:

make clean
nix-shell -j auto --cores 0 --run 'make -B .envrc'
./start

If you have any problems with updating, let us know on the brand new IHP forum.

📧 To stay in the loop, subscribe to the IHP release emails. Or follow digitally induced on twitter..

📅 The next release is expected to be released on 18.09.2020.

Also a short update on IHP Cloud: We're sending out the first IHP Cloud invites in the coming days 🔥

• Depoyment Documentation: Finally it's here. You can find it inside the Guide. Share your IHP apps with the internet! :). You can find details on how to deploy with IHP Cloud or how to deploy your app onto your own infrastructure.
• Nested orderBy: You can now write a query like query @User |> orderBy #firstname |> orderBy #lastname. Previously the last call to orderBy #lastname would overwrite the existing orderBy #firstname. This has been added by @fegu 🎉
• error: file '/build/db/.s.PGSQL.5432' has an unsupported type <- fixed: A long standing issue causing the error message error: file '/build/db/.s.PGSQL.5432' has an unsupported type when starting IHP has been fixed by @ruhatch ! 🎉 This error happend when opening a new nix shell while the dev server is running.
• New Function getSessionAndClear: Returns a session value and removes it from the session
• getRequestUrl has been renamed to getRequestPath to better reflect it's behavior. Also a new getRequestPathAndQuery has been added.
• Basic Support for the jsonb: You can now easily store json inside your postgres with your IHP app. Right now this is just very basic support. Additional support for mapping the json will be added in the future. Currently you need to manually map it using aeson.
• New Function toSlug: toSlug "IHP Release: 18.09.2020" will turn the string into a url friendly version "ihp-release-18-09-2020".

Other Changes

• The default IHP Prelude now exposes more common haskell functions: throw, throwIO, catch, forever
• A nice error screen was added when fetchOne fails because no result was returned
• Application production binaries now accept GHC RTS options at runtime
• Changed ghci prompt from lambda symbol to IHP as this caused encoding issues
• Fixed bug where the redirect url after login did persist for multiple sessions
• IHP's build process has been improved to avoid redundant compilation
• Time renders by dateTime is now working correctly in all locals :) Thanks @dansvo!
• Fixed sql syntax in fetchExists
• One last mention of TurboHaskell (the old name of IHP) has been removed.
• Lots of documentation fixes by @CharlesTaylor7 @fegu @ivanov

Updating

To update the IHP version of your project, open default.nix and change the git commit in line 4 to the following:

rev = "0575a933331d45782ed732a5437ead377e165b29";

After that run the following command to update your project:

nix-shell -j auto --cores 0 --run 'make -B .envrc'

Now you can start your project as usual with ./start.

If you have any problems with updating, let us know on the IHP forum.

📧 To stay in the loop, subscribe to the IHP release emails. Or follow digitally induced on twitter..

📅 The next release is expected to be released on 02.10.2020.

Also a short update on IHP Cloud: We've been busy onboarding new users the last couple of days :) The first apps deployed to IHP Cloud look really cool. We're super excited 🚀

• Realtime UI Updates with IHP AutoRefresh: Whenever a INSERT, UPDATE or DELETE happens to the records used by your action IHP will rerun your action on the serverside. When the generated html looks different to the html generated on the initial page load it will send the new html to the browser using the WebSocket connection. Watch a demo on twitter or Learn more in the Auto Refresh documentation.

• PGNotify Functions: A new module has been added to easily watch for changes inside the database.

• Fancy Errors Disabled in Production: The IHP error handler that tries to be helpful when something goes wrong is now disabled by default in production.

• New function: paramList: Similiar to param but returns a list when the input is something like ingredients=milk&ingredients=egg. Useful when working with checkboxes.

• LIMIT queries: You can now add LIMIT to your sql queries easily when using the query builder:

  topTen <- query @Post 
      |> orderBy #rating
      |> limit 10
      |> fetch
  

• Postgres Arrays: We've added support for types such as int[] or text[]. These types are not visible in the web-based dev tools yet, but can be used manually when using a code editor to edit the Schema.sql.

• New Terminal Command: hash-password: With this new terminal tool you can generate a password hash when setting up the IHP authentication module. It will ask your for the plaintext password and will output the password hash.

• collectionFetchRelated works with QueryBuilder: Previously collectionFetchRelated was not working with certain relationships. This has been fixed and the below code will now work as expected:

  posts <- query @Post 
      |> fetch
      >>= collectionFetchRelated #comments
  

Other Changes

- The image upload recipe has been extended to document how the form needs to look when doing image uploads. - Login error messages are now Invalid credentials - Generated.Types is imported by default in the empty Layout.hs - The Contributing documentation now explains how to run the IHP tests - A bug where the FrontController.hs was generated twice was fixed - The version of morphdom used by IHP has been updated - A new textToId function has been added to simplify conversion of text or bytestrings to db ids - Missing documentation on fetchCount has been added - New recipe: How to generate a random string - New function: sqlQueryScalar similiar to sqlQuery but returns a scalar value - Fixed scripts not working in dev mode - Fixed awk warning when running make static/prod.js

Updating

To update the IHP version of your project, open default.nix and change the git commit in line 4 to the following:

rev = "c4d2815f064c055cd957389a4df5eab25294dba3";

After that run the following command to update your project:

nix-shell -j auto --cores 0 --run 'make -B .envrc'

Now you can start your project as usual with ./start.

If you have any problems with updating, let us know on the IHP forum.

📧 To stay in the loop, subscribe to the IHP release emails. Or follow digitally induced on twitter..

📅 The next release is expected to be released on 16.10.2020.

If you haven't looked already, check out the IHP Auto Refresh Demo 🚀

• Database Connection Pool: IHP now comes with a new database connection pool. This allows for better scalability and performance when dealing with many queries. It also makes IHP more reliable: In previous versions of IHP, a long running database connection might be closed by the database server when nothing happens for too long. This issue will not happen anymore with the new db connection pool.

• Live Reloading Improvements: A bug has been fixed that caused the live reloading not to work when a file was changed. Additionally the web-based compiling status view has been rewritten to be more efficient (you can really feel that it's faster now).

• LocalTime Support: Support for TIMESTAMP WITHOUT TIME ZONE has been added. It works similiar to the normal timestamp you already know from IHP, but doesn't store any Timezone information.

• Welcome Page In Project: When generating a new IHP project, the project now contains the initial welcome action as part of the project code. This allows to for more play when just starting out, because now you can just change the welcome view as you like :)

• Basic Auth: Finally you can have basic auth prompts in IHP. You can use it like this:

      instance Controller WidgetsController where
          beforeAction = basicAuth "sanja" "hunter2" "myapp"
  

  This requires the user to enter sanja with password hunter2 when trying to access the WidgetsController. Check the documentation for details.

• BYTEA Works (again): In the last release we broke binary columns. The schema designer always replaced BYTEA inside your Schema.sql with BINARY. That's fixed now.

• Self-referencing Table Relationships: Let's say you have a table users with a column invited_by_user_id. Previously a table definition like this caused a code generation error in IHP. We've now fixed the technical limitation that caused the issue and now you can build tables like that.

Other Changes

• The nixpkgs Version used when developing on IHP itself has been updated to reflect the new nixpkgs version used since the last release in IHP apps
• Postgres Array Types can be used from the Schema Designer now. Previously this was only possible by using a code editor and manually editing the Schema.sql
• INSERT, UPDATE, DELETE queries now work in the custom sql query box inside the IHP Data Editor
• We've updated the IHP Readme. Take a look in GitHub
• NixSupport/shell.nix moved to just shell.nix. Good to know when you're doing development on the framework itself
• Enums are placed before tables in the Schema.sql. This avoids issues where a CREATE TABLE statements uses an enum that hasn't been defined yet.
• The confirmation then on delete links can be customized using data-confirm: <a href={DeleteProjectAction} data-confirm={"Do you really want to delete" <> get #name project <> "?"}>Delete project</a>
• The development-mode not found handler now gives you a hint that you might want to use js-delete for your link.
• The Troubleshooting section has moved from the GitHub Wiki to the Guide. GitHub Wiki didn't allow for PRs.
• Most build warnings you've seen when building IHP have been fixed
• The application server will not print out the verbose development logs when running production. In production the request log will now be similiar to the log lines from apache. This ensures that e.g. security credentials are not leaked to the application log.
• ihp-new now sets the correct permissions to the .ghci when starting a new project. This has caused troubles in the past for some new users
• The .stylish-haskell config file that's part of all IHP projects by default has been updated to work again with the latest IHP version
• Lots of documentation updates

Updating

First open default.nix and change the git commit in line 4 to the following:

rev = "a8030dd1e4041a0353f63d03b4ffb836cb2bd95c";

After that run the following command to update your project:

nix-shell -j auto --cores 0 --run 'make -B .envrc'
make -B build/ihp-lib

Now you can start your project as usual with ./start.

Aside from all the code changes above we've also updated the IHP website: https://ihp.digitallyinduced.com/ :) First big refresh after IHP has been published around 4 months ago.

If you have any problems with updating, let us know on the IHP forum.

📧 To stay in the loop, subscribe to the IHP release emails. Or follow digitally induced on twitter..

📅 The next release is expected to be released on 13.11.2020.

• Haskell Language Server Support: You can now get cool IDE features by using Haskell Language Server. It works mostly out of the box after updating to this IHP version. Check out the documentation on how to get it running with your fav editor.

  

• Updated NixPkgs Version: We're updating the IHP package set to a newer version. We're moving from da7ddd822e32aeebea00e97ab5aeca9758250a40 to 07e5844fdf6fe99f41229d7392ce81cfe191bcfc. This means some of your dependencies might get updated.

• OFFSET Support: You can now easily use Postgres OFFSET with the query builder:

  query @User 
      |> limit 25
      |> offset 50
      |> fetch
  

• New Form Helper: numberField: Similiar to textField, renders a <input type="number"/>.

  formFor project [hsx|
      {numberField #maxUsersLimit}
  |]
  

• Automatic Troubleshooting: We've created a script that checks all common issues that often go wrong when setting up IHP (like direnv issues, .ghci permission issues, etc.). When you cannot run your IHP app anymore, run the troubleshooting to find out possible error conditions. You can find more in the Troubleshooting section.

• Sending Emails: Support for sending mails has been added in this release. Use the new code generator to get started 🔥

Other Changes

• param @Bool now accepts true as a truthy value.
• Session cookies can be configured in FrameworkConfig. Previously it was not possible to change any options of the session cookie.
• Session cookies are HttpOnly and secure (only if app is served via https) now
• The built-in SessionsController provides a new beforeLogin callback. This can be useful to abort the login process when a user is not yet confirmed.
• urlTo can now be used everywhere where pathTo is used
• A stripTags function has been added to HaskellSupport. This function removes all html tags from an input string.
• Docu: The recipe Uploading a user profile picture now mentions that the picture_url should be nullable
• Docu: Limit and Offset are documented now.
• Id values such as Id Project now have Ord and Hashable instances by default
• The action generator has been fixed
• Various tests have been added to test HSX, NameSupport and more
• Several issues with the Data Tool have been fixed. E.g. adding a row works again now.
• Docu: Using IHP with Emacs has been added
• Docu: Using IHP with Vim has been added
• The textToId function now also works with text primary keys. Previously it only worked with UUIDs.
• The postgresql-simple Only wrapper is now exported to all controllers
• Improved support for using a Binary (BYTEA) column in a table

Updating

This release requires a few more steps than usual. As we've changed the nixpkgs version, this will also require a lot of redownloading of all packages. Make sure you have good internet and can wait up to 30 minutes to complete the download. We highly suggest to make sure your coffee machine is working before starting the update.

First open default.nix and change the git commit in line 4 to the following:

rev = "49816c21d34fd7894a956bf7fd997e6ed5243acf";

Open Config/nix/nixpkgs-config.nix and replace the file with this new version: https://raw.githubusercontent.com/digitallyinduced/ihp-boilerplate/81518e9b66e1e9d3bdf40affa674a7d2cd63f414/Config/nix/nixpkgs-config.nix

After that run the following command to update your project:

# Be aware that this will redownload a lot of files and take lots of time
nix-shell -j auto --cores 0 --run 'make -B .envrc'
make -B build/ihp-lib

# This step is required to get the config files for haskell-language-server
make hie.yaml

Now you can start your project as usual with ./start.

Check out the docs to get started with haskell language server to get cool IDE features.

If you have any problems with updating, let us know on the IHP forum.

📧 To stay in the loop, subscribe to the IHP release emails. Or follow digitally induced on twitter..

📅 The next release is expected to be released on 30.10.2020.

• Improved Schema Designer Error Messages: Possible errors that happen when you run Update DB will now be displayed in a more useful way. Previously the error message just displayed the full postgresql output in a single line. Now the error message is displayed like this:
• Tailwind Documentation: We added documentation on how to integrate tailwindcss into your IHP projects. You can find the guide here: https://ihp.digitallyinduced.com/Guide/tailwindcss.html
• NPM Documentation: We also added a short documentation on how to work with NPM and the JS ecosystem in your IHP projects. You can find the guide here: https://ihp.digitallyinduced.com/Guide/npm.html
• IHP Telemetry: To answer questions like How many people are running at which IHP version? What is the primary OS people are using IHP on? How many active users are working with IHP? we added Telemetry to the local dev server that runs when you call ./start. The dev server reports ihpVersion, os, architecture and a anonymous project id to ihp-telemetry.digitallyinduced.com. You can opt-out by setting a env var IHP_DISABLE_TELEMETRY=1
• Schema Designer: ON DELETE SET DEFAULT: Next to ON DELETE SET NULL you can now use SET DEFAULT.
• Postgres Point Type: You can now use tables that have a POINT column in IHP. The Point type is also supported inside the param functions.

Other Changes

• Old references to ViewContext in the docu have been updated
• The New Migration Generator now automatically creates the Application/Migration directory on first use
• When setLayout is not called inside the application lifecycle IHP will now continue to render a view. Previously it would crash when calling render without a layout.
• Fixed a bug where migration without a description would not be found by the migrate command
• The documentation now has a more visible Next button at the bottom of the first sections.
• Fixed paramOrDefault failing on empty parameters. We also added tests to make sure this won't happen again.
• The IHP version is now displayed when running the dev server in debug mode (DEBUG=1 ./start).
• Some IHP build warnings have been fixed.
• Fixed a regression where the production request logger was not used anymore in production environments by default.
• Removed the error state Cannot start app as postgres is not ready yet. This error cannot happen anymore since we added database pools. Usually when this happens it's usually a false alarm.

Updating

See the UPGRADE.md for upgrade instructions.

If you have any problems with updating, let us know on the IHP forum. Or join our new slack.

📧 To stay in the loop, subscribe to the IHP release emails. Or follow digitally induced on twitter..

📅 The next release is expected to be released on 11.12.2020.

• Job Queue: We added a new job queue system that allows you to schedule jobs that are going to be executed outside the normal request-response cycle by a job worker running in the background. Documentation for this will follow soon. <img width="1904" alt="Bildschirmfoto 2020-12-13 um 14 15 48" src="https://user-images.githubusercontent.com/2072185/102013026-c6156880-3d4d-11eb-89d0-66040ab2ebc2.png">
• Documentation Improvements: Lots of typos, unclear wording and outdated code samples have been fixed.
• New Function: deleteRecordById: Like deleteRecord but you can pass an id instead of a full record.

Other Changes

• startPage now works with apps other than Web
• Improvements when using haskell or sql keywords in the schema designer
• Use bytestring for sql table names everywhere. This removes inefficient transforming table names from Text to bytestring and back all the time.
• The nonEmpty validator now works with Id record values
• Fixed an SQL error caused by inserting an postgres array column
• Added InputValue Aeson.Value instance, so form fields can be used with json fields
• Fixed js-delete breaks when html anchor is not the leaf element
• Haskell Code generated by HSX is more efficient now
• Improved inline behavior of lots of IHP functions

Updating

See the UPGRADE.md for upgrade instructions.

If you have any problems with updating, let us know on the IHP forum.

📧 To stay in the loop, subscribe to the IHP release emails. Or follow digitally induced on twitter..

📅 The next release is expected to be released on 08.01.2021.