Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Sample Project Ideas #23

Closed
pimbrouwers opened this issue Jul 3, 2020 · 9 comments
Closed

Sample Project Ideas #23

pimbrouwers opened this issue Jul 3, 2020 · 9 comments
Labels
discussion enhancement New feature or request question Further information is requested

Comments

@pimbrouwers
Copy link
Owner

Opening the floor to ideas for sample projects.

We currently have:

  • Hello world
  • Markdown blog

Some of my ideas:

  • Todo MVC (kind of boring)
  • A restaurant booking system (a la @ploeh)
  • A public notepad (i.e. jsfiddle for plain-text)
@pimbrouwers pimbrouwers added enhancement New feature or request question Further information is requested discussion labels Jul 3, 2020
@waghanza
Copy link

waghanza commented Jul 9, 2020

There is also https://github.com/gothinkster/realworld @pimbrouwers

@rishavs
Copy link

rishavs commented Jul 12, 2020

+1 for Realworld. Nothing better than a full webapp done in a framework to gauge its strengths and weaknesses.

Also consider 2 more sample projects;

  • Falco API server with a SPA frontend + authentication and security best practices
  • Falco API server with Fable frontend.

Also, do consider outting the framework on Techempower. Techempower is fairly ubiquitous nowadays and it will be great to see how well Falco stacks up against other frameworks in pure performance, even if pure performance may not be the Falco goal. Having this data will be extremely helpful to people who are hesitant to try out F# as there is so low representation for fsharp tools and libraries in all these conversations.

https://www.techempower.com/benchmarks/

@pimbrouwers
Copy link
Owner Author

pimbrouwers commented Jul 12, 2020

Thanks guys! Realworld seems like a great project. I'll see what I can do.

@rishavs We're actually already on techempower! I haven't done a PR for v2.0.0 yet though. I'm not really a SPA person, so I'd want to collaborate with more of an expert on that type of project. Totally open to it though.

@bytesource
Copy link
Contributor

This maybe is a bit off-topic, but whatever project you choose, I think it would be great if you could add a step-by-step tutorial on how you built everything and your reasoning behind it.

I'm relatively new to F# and learning only by desecting code often leads to frustrations, either because I don't understand a certain line of code and get stuck or because I want to know the "Why" behind an implementation.

In fact, at this point, I'm more and more making decisions based on available real-world tutorials, as these allow me to make real progress ("actionable" as marketers like to say).

For example, I wanted to learn Bolero, but the tutorial on the website only gives a broad overview, which is not enough to use it in a project. On the other side, Zaid Ajaj wrote a book about Elmish, https://zaid-ajaj.github.io/the-elmish-book/#/, so I sticked with Elmish.

Just my two cents...

Stefan

@delneg
Copy link

delneg commented Jul 13, 2020

You can also take a look at https://github.com/atsapura/CardManagement

@pimbrouwers
Copy link
Owner Author

Thanks @delneg I'll check that out.

Development of the @gothinkster real-world app is taking place here: https://github.com/pimbrouwers/realworld-starter-kit

@brettrowberry
Copy link

Mostly, I want to see a good way to document APIs with OpenAPI/Swagger - whether manually, automatically, or somewhere in between.

@pimbrouwers pimbrouwers pinned this issue Nov 12, 2020
@pimbrouwers
Copy link
Owner Author

@brettrowberry -- Sounds good. I imagine you're not alone, so how about over the holiday's I get a little more informed on the topic of OpenAPI v. Swagger and I'll do a little tutorial for the samples directory.

I'm also hopeful to finish the gothinkster impl. soon as well now that API and some higher patterns have solidified.

@brettrowberry
Copy link

brettrowberry commented Dec 6, 2020

Look at the index.html and swagger.JSON for a minimal working example. Basically, Swagger UI needs an OpenAPI document hosted on a known endpoint in either JSON or YML format.
https://github.com/brettrowberry/okapi/tree/main/WebRoot. Some people might not be ok with getting the static assets referenced in the index.html from a CDN, but I think it’s fine to start with.

@pimbrouwers pimbrouwers unpinned this issue Jan 16, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
discussion enhancement New feature or request question Further information is requested
Projects
None yet
Development

No branches or pull requests

6 participants